persona-harness 0.3.0-alpha.0 → 0.3.0-alpha.2

package/.persona/harness.jsonc

@@ -5,5 +5,5 @@
   "maxRulesPerInjection": 12,
   "evidenceMode": "metadata_only",
   "scenario": "step1",
-  "enabledDomains": ["backend", "frontend", "infra", "programming"]
+  "enabledDomains": ["backend", "programming"]
 }

package/.persona/rules/backend/java-backend-bootstrap.md

@@ -18,11 +18,12 @@ enforcement: inject_only
 - 구현 전에 package structure plan을 작성한다. root package 바로 아래에 `global`과 `root/<domain>`을 같은 depth로 두고, `feature/features/module/modules` 같은 wrapper package를 추가하지 않는다.
 - 도메인 package 내부는 presentation/application/domain/infrastructure 흐름을 기본으로 두고 `root/<domain>/presentation`, `root/<domain>/application`, `root/<domain>/domain`, `root/<domain>/infrastructure`로 배치한다.
 - DTO는 파일 경계로 둔다. Presentation DTO는 `root/<domain>/presentation/dto/request`와 `root/<domain>/presentation/dto/response`, Application DTO는 `root/<domain>/application/dto/command`와 `root/<domain>/application/dto/result`에 둔다.
-- 구현 중에는 package structure plan을 기준으로 Domain, Repository, Service, DTO, Controller 역할 파일을 만들고 주요 Java 파일을 다시 읽고 다음 역할로 넘어간다.
+- 구현 중에는 package structure plan을 기준으로 Domain, Repository, Service, DTO, Controller 역할 파일을 만들고 주요 Java 파일을 다시 읽고 다음 역할로 넘어간다. Domain entity/aggregate가 static factory를 쓰면 public constructor가 아니라 private constructor로 생성 경로를 닫는다.
 - presentation은 HTTP 요청/응답과 request/response DTO boundary를 담당하고, application service에 위임한다.
 - Application Service는 use-case 흐름 조율만 담당하며 Service는 Map/List/AtomicLong/nextId/idCounter 같은 저장소 상태나 id sequence를 직접 소유하지 않는다.
 - 저장소 상태와 id generation은 Repository/Store 같은 persistence/storage component 뒤로 위임한다.
 - Repository interface는 domain 경계에 `root/<domain>/domain/<Domain>Repository`로 두고 구현체는 infrastructure 경계에 `Jdbc<Domain>Repository` 또는 `InMemory<Domain>Repository`로 둔다.
 - Domain은 Spring, HTTP, DB, infrastructure 세부사항에 의존하지 않는다.
 - Domain entity/aggregate는 record 데이터 홀더로 만들지 않는다. 자신의 필드로 판단할 수 있는 규칙은 `isOwner(name)`, `isReturned()`, `canLoan()` 같은 의미 있는 메서드로 Domain 객체가 직접 판단하고, Application Service가 getter/accessor로 필드를 꺼내 판단하지 않는다.
+- Domain entity/aggregate가 `create`, `restore`, `of` 같은 static factory로 생성 경로를 제공하면 public constructor를 열지 않고 private constructor로 닫는다.
 - frontend, infra, test-quality, generated app product-quality 보증은 현재 bootstrap injection 범위 밖이다.

package/.persona/rules/backend/spring-entity.md

@@ -14,6 +14,7 @@ enforcement: inject_only
 
 - Entity/Aggregate는 record 데이터 홀더로 만들지 않고 class로 둔다. record는 Request/Response DTO, Command/Result DTO, 값 자체가 의미인 Value Object에만 제한한다.
 - Entity는 setter를 열지 않는다.
+- `create`, `restore`, `of` 같은 static factory를 쓰는 Entity/Aggregate는 public constructor를 열지 않고 private constructor로 생성 경로를 닫는다.
 - 상태 변경은 의미 있는 메서드로만 한다.
 - 도메인 불변식은 Entity나 Domain 객체 안에서 지킨다.
 - 자신의 필드만으로 판단할 수 있는 규칙은 Entity/Domain 객체가 직접 판단한다. 예: `isOwner(name)`, `isReturned()`, `canLoan()` 같은 메서드를 두고, Service가 `entity.name()`/getter/accessor를 꺼내 같은 판단을 대신하지 않는다.

package/CHANGELOG.md

@@ -2,9 +2,36 @@
 
 All notable Persona Harness changes are recorded here.
 
-This project uses npm prerelease versions for tester-facing alpha builds. Stable `latest` releases are deferred until the Java/Spring backend MVP has enough external tester feedback.
+This project uses npm prerelease versions for tester-facing alpha builds. During the alpha pilot, `latest` is kept on the current alpha build to avoid stale default installs. Stable support guarantees are still deferred.
 
-## [0.3.0-alpha.0] - Unreleased
+## [0.3.0-alpha.2] - Unreleased
+
+### Changed
+
+- Promoted the P0 plan-first CLI, diagnostics, scope, and bearshell hardening line to the next alpha candidate because the published `0.3.0-alpha.1` package still printed the old implementation-first `ph init` guidance.
+- Updated release automation so prerelease publishes also move the npm `latest` dist-tag to the same current alpha/beta version, avoiding stale default installs.
+- Documented the full OpenCode prerequisite flow before Persona Harness setup.
+- Added OpenCode provider/model connection steps using `opencode auth login`, `opencode auth list`, `/connect`, and `/models`.
+- Clarified that Persona Harness planning files can be created without OpenCode, but plugin injection and evidence capture require OpenCode.
+- Updated external tester docs to use the published `persona-harness@alpha` install path.
+- Added GitHub Actions release automation for verify, npm publish on version tags, and generated GitHub release notes.
+- Tightened workflow prompts and report templates to prefer `npx ph bearshell` for repo inspection, Gradle verification, and smoke commands.
+- Clarified that clean project agents should call Persona Harness through `npx ph ...`, not a globally installed `ph`.
+- Clarified Java backend bootstrap guidance so domain static factories close creation through private constructors.
+- Changed `ph init` next steps to the plan-first flow: intake, policy, plan, accept or revise, then implementation.
+- Narrowed default `enabledDomains` to the Java backend MVP surface: `backend` and `programming`.
+- Added diagnostics-only reporting for malformed `.persona/harness.jsonc` instead of silently hiding the fallback.
+- Added a default `ph bearshell` command timeout with `PH_BEARSHELL_TIMEOUT_MS` override, while keeping the command helper explicitly non-sandboxed.
+
+## [0.3.0-alpha.1] - 2026-06-21
+
+### Changed
+
+- Published the first tester-facing alpha line after `0.3.0-alpha.0`.
+- Added OpenCode prerequisite and provider/model setup documentation.
+- Prepared release automation and external tester guidance, but the published package still had stale `ph init` implementation-first output.
+
+## [0.3.0-alpha.0] - 2026-06-21
 
 ### Added
 
@@ -28,8 +55,7 @@ This project uses npm prerelease versions for tester-facing alpha builds. Stable
 
 ### Known Gaps
 
-- npm public publish has not been completed yet.
-- `latest` dist-tag is intentionally deferred.
+- The current alpha line still needs external tester feedback before stable support guarantees.
 - Generated app product quality is not certified.
 - Rule compliance is not enforced by AST, linter, or build failure gates.
 - Frontend, infra, desktop, and full TDD workflows remain future tracks.

package/README.ja.md

@@ -9,9 +9,51 @@ Persona Harness は、エージェントが空のプロジェクトから始め
 > 現在の範囲: Java/Spring backend MVP.
 > frontend、infra、desktop app、AST/linter enforcement、完全な TDD workflow は今後の対象です。
 
+## Requirements
+
+- Node.js 20+
+- npm
+- OpenCode terminal CLI
+- OpenCode に設定済みの model/provider
+
 ## Quick Start
 
-npm alpha publish 後:
+まず OpenCode をインストールします。OpenCode 公式ドキュメントでは install script または npm global install が案内されています。
+
+```bash
+curl -fsSL https://opencode.ai/install | bash
+```
+
+または:
+
+```bash
+npm install -g opencode-ai
+```
+
+確認:
+
+```bash
+opencode --version
+opencode
+```
+
+OpenCode に model provider を接続します。
+
+```bash
+opencode auth login
+opencode auth list
+```
+
+または OpenCode TUI で実行します。
+
+```text
+/connect
+/models
+```
+
+Model ID は `provider/model` 形式です。例: `openai/gpt-5.4-mini-fast`.
+
+次に Java/Spring backend project で Persona Harness をインストールします。
 
 ```bash
 npm install -D persona-harness@alpha
@@ -21,7 +63,7 @@ npx ph policy init
 npx ph plan
 ```
 
-public publish 前の local flow:
+Persona Harness 自体を開発する場合は local install を使います。
 
 ```bash
 npm install -D /absolute/path/to/persona-harness
@@ -35,7 +77,7 @@ npx ph plan
 
 ```bash
 opencode run --dir . --model <model> --dangerously-skip-permissions \
-  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.mdを読み、実装せず architecture/technology plan だけを完成させてください。"
+  "$(npx ph plan --prompt)"
 ```
 
 plan が十分なら accept します。
@@ -49,7 +91,7 @@ npx ph plan --accept
 
 ```bash
 opencode run --dir . --model <model> --dangerously-skip-permissions \
-  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.mdを読み、plan が accepted であることを確認してから Java/Spring Gradle ベースで要求全体を実装してください。実装後に gradle test, gradle build, gradle bootRun, HTTP happy path と failure path smoke を実行し、.persona/workflow/implementation-report.md と .persona/workflow/review-report.md を記入してください。"
+  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.mdを読み、plan が accepted であることを確認してから Java/Spring Gradle ベースで要求全体を実装してください。コマンド実行は可能なら npx ph bearshell を使い、実装後に npx ph bearshell gradle test, npx ph bearshell gradle build, 実行可能な Spring Boot app なら npx ph bearshell --shell 'gradle bootRun --args=\"--server.port=<port>\"', HTTP happy path と failure path smoke を実行してください。.persona/workflow/implementation-report.md と .persona/workflow/review-report.md を記入し、npx ph plan --report-filled implementation と npx ph plan --report-filled review を実行してください。"
 ```
 
 ## 提供するもの
@@ -79,6 +121,7 @@ opencode run --dir . --model <model> --dangerously-skip-permissions \
 - test sufficiency の証明
 - frontend, infra, desktop workflow の productization
 - 最終的な TDD workflow
+- OpenCode なしの独立 agent workflow
 
 ## Docs
 

package/README.ko.md

@@ -9,9 +9,51 @@ Persona Harness는 에이전트가 빈 프로젝트에서 시작해 backend 맥
 > 현재 범위: Java/Spring backend MVP.
 > frontend, infra, desktop app, AST/linter enforcement, 완전한 TDD workflow는 후속 트랙입니다.
 
+## 요구사항
+
+- Node.js 20+
+- npm
+- OpenCode terminal CLI
+- OpenCode에 연결된 model/provider
+
 ## 빠른 시작
 
-npm alpha publish 이후:
+먼저 OpenCode를 설치합니다. OpenCode 공식 문서 기준으로 install script 또는 npm global install을 사용할 수 있습니다.
+
+```bash
+curl -fsSL https://opencode.ai/install | bash
+```
+
+또는:
+
+```bash
+npm install -g opencode-ai
+```
+
+설치 확인:
+
+```bash
+opencode --version
+opencode
+```
+
+OpenCode에 model provider를 연결합니다.
+
+```bash
+opencode auth login
+opencode auth list
+```
+
+또는 OpenCode TUI에서 실행합니다.
+
+```text
+/connect
+/models
+```
+
+모델 ID는 `provider/model` 형식입니다. 예: `openai/gpt-5.4-mini-fast`.
+
+그 다음 Java/Spring backend 프로젝트에서 Persona Harness를 설치합니다.
 
 ```bash
 npm install -D persona-harness@alpha
@@ -21,7 +63,7 @@ npx ph policy init
 npx ph plan
 ```
 
-public publish 전 로컬 개발 흐름:
+Persona Harness 자체를 개발 중이면 local install을 사용합니다.
 
 ```bash
 npm install -D /absolute/path/to/persona-harness
@@ -35,7 +77,7 @@ npx ph plan
 
 ```bash
 opencode run --dir . --model <model> --dangerously-skip-permissions \
-  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md를 읽고 구현하지 말고 architecture/technology plan만 완성해줘."
+  "$(npx ph plan --prompt)"
 ```
 
 계획이 충분하면 수락합니다.
@@ -49,7 +91,7 @@ npx ph plan --accept
 
 ```bash
 opencode run --dir . --model <model> --dangerously-skip-permissions \
-  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md를 읽고 plan이 accepted 상태인지 확인한 뒤 Java/Spring Gradle 기반으로 요구사항 전체를 구현해줘. 구현 후 gradle test, gradle build, gradle bootRun, HTTP happy path와 failure path smoke를 실행하고 .persona/workflow/implementation-report.md와 .persona/workflow/review-report.md를 채워줘."
+  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md를 읽고 plan이 accepted 상태인지 확인한 뒤 Java/Spring Gradle 기반으로 요구사항 전체를 구현해줘. 명령 실행은 가능하면 npx ph bearshell로 하고, 구현 후 npx ph bearshell gradle test, npx ph bearshell gradle build, 실행 가능한 Spring Boot 앱이면 npx ph bearshell --shell 'gradle bootRun --args=\"--server.port=<port>\"', HTTP happy path와 failure path smoke를 실행해줘. .persona/workflow/implementation-report.md와 .persona/workflow/review-report.md를 채우고 npx ph plan --report-filled implementation 및 npx ph plan --report-filled review를 실행해줘."
 ```
 
 ## 제공하는 것
@@ -79,6 +121,7 @@ opencode run --dir . --model <model> --dangerously-skip-permissions \
 - 테스트 충분성 증명
 - frontend, infra, desktop workflow productization
 - 최종 TDD workflow
+- OpenCode 없는 독립 agent workflow
 
 ## 문서
 

package/README.md

@@ -9,9 +9,51 @@ Persona Harness helps an agent start from a clean project, ask for backend conte
 > Current scope: Java/Spring backend MVP.
 > Frontend, infra, desktop app, AST/linter enforcement, and full TDD workflow are future tracks.
 
+## Requirements
+
+- Node.js 20+
+- npm
+- OpenCode terminal CLI
+- A model/provider configured in OpenCode
+
 ## Quick Start
 
-Alpha package flow, after npm alpha publish:
+Install OpenCode first. The official OpenCode docs recommend the install script, or a global npm install:
+
+```bash
+curl -fsSL https://opencode.ai/install | bash
+```
+
+or:
+
+```bash
+npm install -g opencode-ai
+```
+
+Verify it:
+
+```bash
+opencode --version
+opencode
+```
+
+Connect a model provider in OpenCode:
+
+```bash
+opencode auth login
+opencode auth list
+```
+
+You can also open the OpenCode TUI and run:
+
+```text
+/connect
+/models
+```
+
+Use model IDs in `provider/model` format, for example `openai/gpt-5.4-mini-fast`.
+
+Then install Persona Harness in your Java/Spring backend project:
 
 ```bash
 npm install -D persona-harness@alpha
@@ -21,7 +63,7 @@ npx ph policy init
 npx ph plan
 ```
 
-Local development flow, before public publish:
+If you are developing Persona Harness itself, use a local install instead:
 
 ```bash
 npm install -D /absolute/path/to/persona-harness
@@ -35,7 +77,19 @@ Then ask OpenCode to plan first:
 
 ```bash
 opencode run --dir . --model <model> --dangerously-skip-permissions \
-  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md를 읽고 구현하지 말고 architecture/technology plan만 완성해줘."
+  "$(npx ph plan --prompt)"
+```
+
+If you prefer the OpenCode TUI, open it from the project root:
+
+```bash
+opencode
+```
+
+Then paste the output of:
+
+```bash
+npx ph plan --prompt
 ```
 
 Accept the plan when it is good enough:
@@ -49,7 +103,7 @@ Then ask OpenCode to implement:
 
 ```bash
 opencode run --dir . --model <model> --dangerously-skip-permissions \
-  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md를 읽고 plan이 accepted 상태인지 확인한 뒤 Java/Spring Gradle 기반으로 요구사항 전체를 구현해줘. 구현 후 gradle test, gradle build, gradle bootRun, HTTP happy path와 failure path smoke를 실행하고 .persona/workflow/implementation-report.md와 .persona/workflow/review-report.md를 채워줘."
+  "README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md를 읽고 plan이 accepted 상태인지 확인한 뒤 Java/Spring Gradle 기반으로 요구사항 전체를 구현해줘. 명령 실행은 가능하면 npx ph bearshell로 하고, 구현 후 npx ph bearshell gradle test, npx ph bearshell gradle build, 실행 가능한 Spring Boot 앱이면 npx ph bearshell --shell 'gradle bootRun --args=\"--server.port=<port>\"', HTTP happy path와 failure path smoke를 실행해줘. .persona/workflow/implementation-report.md와 .persona/workflow/review-report.md를 채우고 npx ph plan --report-filled implementation 및 npx ph plan --report-filled review를 실행해줘."
 ```
 
 ## What You Get
@@ -58,7 +112,7 @@ opencode run --dir . --model <model> --dangerously-skip-permissions \
 - `ph intake --interactive`: asks backend project questions and writes `.persona/project-profile.jsonc`.
 - `ph policy init`: creates company and personal backend policy overlay files.
 - `ph plan`: creates `.persona/workflow/plan.md` for the `blackbear` planning role.
-- `ph bearshell`: runs bounded shell commands through the Persona Harness command surface.
+- `ph bearshell`: runs timeout-bounded and output-bounded shell commands through the Persona Harness command surface.
 - `ph history`: snapshots used workflow artifacts into `.persona/workflow/history/`.
 - OpenCode injection: adds Java/Spring backend Clean Code context when the agent reads relevant project files.
 
@@ -79,6 +133,8 @@ opencode run --dir . --model <model> --dangerously-skip-permissions \
 - It does not prove tests are sufficient.
 - It does not productize frontend, infra, or desktop workflows yet.
 - It is not the final TDD workflow yet.
+- It is not useful as a full agent workflow without OpenCode.
+- `ph bearshell` is not a sandbox. It limits runtime and output size, but commands still run on your machine.
 
 ## For Humans
 

package/README.zh-cn.md

@@ -9,9 +9,51 @@ Persona Harness 帮助代理从空项目开始，先收集 backend 背景，生
 > 当前范围: Java/Spring backend MVP.
 > frontend、infra、desktop app、AST/linter enforcement、完整 TDD workflow 都是后续方向。
 
+## Requirements
+
+- Node.js 20+
+- npm
+- OpenCode terminal CLI
+- 已在 OpenCode 中配置的 model/provider
+
 ## 快速开始
 
-npm alpha publish 之后:
+先安装 OpenCode。OpenCode 官方文档推荐 install script，也可以使用 npm global install。
+
+```bash
+curl -fsSL https://opencode.ai/install | bash
+```
+
+或者:
+
+```bash
+npm install -g opencode-ai
+```
+
+确认安装:
+
+```bash
+opencode --version
+opencode
+```
+
+在 OpenCode 中连接 model provider。
+
+```bash
+opencode auth login
+opencode auth list
+```
+
+也可以在 OpenCode TUI 中运行:
+
+```text
+/connect
+/models
+```
+
+Model ID 使用 `provider/model` 格式，例如 `openai/gpt-5.4-mini-fast`.
+
+然后在 Java/Spring backend 项目中安装 Persona Harness。
 
 ```bash
 npm install -D persona-harness@alpha
@@ -21,7 +63,7 @@ npx ph policy init
 npx ph plan
 ```
 
-public publish 之前的本地流程:
+如果你正在开发 Persona Harness 本身，请使用 local install。
 
 ```bash
 npm install -D /absolute/path/to/persona-harness
@@ -35,7 +77,7 @@ npx ph plan
 
 ```bash
 opencode run --dir . --model <model> --dangerously-skip-permissions \
-  "请阅读 README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md，不要实现代码，只完成 architecture/technology plan。"
+  "$(npx ph plan --prompt)"
 ```
 
 计划足够清楚后接受它:
@@ -49,7 +91,7 @@ npx ph plan --accept
 
 ```bash
 opencode run --dir . --model <model> --dangerously-skip-permissions \
-  "请阅读 README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md，确认 plan 是 accepted 状态，然后基于 Java/Spring Gradle 实现全部需求。实现后运行 gradle test, gradle build, gradle bootRun, HTTP happy path 和 failure path smoke，并填写 .persona/workflow/implementation-report.md 与 .persona/workflow/review-report.md。"
+  "请阅读 README.md, .persona/project-profile.jsonc, .persona/policies, .persona/workflow/plan.md，确认 plan 是 accepted 状态，然后基于 Java/Spring Gradle 实现全部需求。执行命令时尽量使用 npx ph bearshell；实现后运行 npx ph bearshell gradle test, npx ph bearshell gradle build；如果是可运行的 Spring Boot app，运行 npx ph bearshell --shell 'gradle bootRun --args=\"--server.port=<port>\"'；再执行 HTTP happy path 和 failure path smoke。填写 .persona/workflow/implementation-report.md 与 .persona/workflow/review-report.md，并运行 npx ph plan --report-filled implementation 和 npx ph plan --report-filled review。"
 ```
 
 ## 提供内容
@@ -79,6 +121,7 @@ opencode run --dir . --model <model> --dangerously-skip-permissions \
 - 测试充分性证明
 - frontend, infra, desktop workflow productization
 - 最终 TDD workflow
+- 没有 OpenCode 的独立 agent workflow
 
 ## Docs
 

package/dist/cli/bearshell.js

@@ -1,7 +1,9 @@
 import { spawnSync } from "node:child_process";
 import process from "node:process";
 const DEFAULT_BUDGET = 20_000;
+const DEFAULT_TIMEOUT_MS = 30_000;
 const MIN_BUDGET = 80;
+const MIN_TIMEOUT_MS = 1;
 export function bearshellUsage(invocation = "ph") {
     return [
         `Usage: ${invocation} bearshell <command> [args...]`,
@@ -14,6 +16,7 @@ export function bearshellUsage(invocation = "ph") {
         "Environment:",
         "- PH_BEARSHELL_CONDENSE=0 disables output condensation.",
         "- PH_BEARSHELL_CONDENSE_BUDGET overrides the default condensation budget.",
+        "- PH_BEARSHELL_TIMEOUT_MS overrides the default 30000ms command timeout.",
         "- PH_BEARSHELL_SPARK=0 is accepted for OMO compatibility; this MVP uses deterministic condensation only.",
     ].join("\n");
 }
@@ -33,22 +36,30 @@ export function runBearshell(args, options = {}) {
             encoding: "utf8",
             env: childEnv,
             shell: true,
+            timeout: parsed.timeoutMs,
+            killSignal: "SIGTERM",
         })
         : spawnSync(parsed.command, [...parsed.args], {
             cwd: options.cwd,
             encoding: "utf8",
             env: childEnv,
             shell: false,
+            timeout: parsed.timeoutMs,
+            killSignal: "SIGTERM",
         });
     const status = spawned.status ?? signalExitCode(spawned.signal);
     const stdout = maybeCondense(toOutputString(spawned.stdout), parsed.budget, env);
-    const stderr = maybeCondense(spawnErrorMessage(parsed.command, spawned.error) ?? toOutputString(spawned.stderr), parsed.budget, env);
+    const stderr = maybeCondense(spawnErrorMessage(parsed.command, spawned.error, parsed.timeoutMs) ?? toOutputString(spawned.stderr), parsed.budget, env);
     return formatResult({ status, stdout, stderr }, parsed.json);
 }
 function parseBearshellArgs(args, env) {
     let json = false;
     let shell = false;
     let budget = readBudget(env["PH_BEARSHELL_CONDENSE_BUDGET"]) ?? DEFAULT_BUDGET;
+    const timeoutMs = readTimeoutMs(env["PH_BEARSHELL_TIMEOUT_MS"]);
+    if (timeoutMs === null) {
+        return { kind: "invalid", json, message: "PH_BEARSHELL_TIMEOUT_MS requires a positive integer" };
+    }
     const positional = [];
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
@@ -68,7 +79,7 @@ function parseBearshellArgs(args, env) {
             if (command === undefined || command.length === 0) {
                 return { kind: "invalid", json, message: "--shell requires a command string" };
             }
-            return { kind: "exec", json, shell: true, budget, command, args: [] };
+            return { kind: "exec", json, shell: true, budget, timeoutMs, command, args: [] };
         }
         if (arg === "--budget") {
             const value = args[index + 1];
@@ -92,7 +103,7 @@ function parseBearshellArgs(args, env) {
     if (command === undefined) {
         return { kind: "help", json };
     }
-    return { kind: "exec", json, shell: false, budget, command, args: positional.slice(1) };
+    return { kind: "exec", json, shell: false, budget, timeoutMs, command, args: positional.slice(1) };
 }
 function readBudget(value) {
     if (value === undefined || value.trim().length === 0) {
@@ -104,6 +115,16 @@ function readBudget(value) {
     }
     return Math.max(parsed, MIN_BUDGET);
 }
+function readTimeoutMs(value) {
+    if (value === undefined || value.trim().length === 0) {
+        return DEFAULT_TIMEOUT_MS;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < MIN_TIMEOUT_MS) {
+        return null;
+    }
+    return parsed;
+}
 function maybeCondense(output, budget, env) {
     if (env["PH_BEARSHELL_CONDENSE"] === "0") {
         return output;
@@ -137,12 +158,21 @@ function formatResult(result, json) {
 function toOutputString(value) {
     return typeof value === "string" ? value : "";
 }
-function spawnErrorMessage(command, error) {
+function spawnErrorMessage(command, error, timeoutMs) {
     if (error === undefined) {
         return undefined;
     }
+    if (errorCode(error) === "ETIMEDOUT") {
+        return `[bearshell] command timed out after ${timeoutMs}ms: ${command}\n`;
+    }
     return `[bearshell] failed to launch ${command}: ${error.message}\n`;
 }
+function errorCode(error) {
+    if (!("code" in error)) {
+        return undefined;
+    }
+    return typeof error.code === "string" ? error.code : undefined;
+}
 function signalExitCode(signal) {
     if (signal === null) {
         return 1;

package/dist/cli/bearshell.js.map

@@ -1 +1 @@
-{"version":3,"file":"bearshell.js","sourceRoot":"","sources":["../../src/cli/bearshell.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bearshell.js","sourceRoot":"","sources":["../../src/cli/bearshell.ts"],"names":[],"mappings":"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"}

package/dist/cli/history.js

@@ -114,7 +114,7 @@ export function archiveWorkflowHistory(options = {}, archiveIdInput) {
         }
     }
     if (archivedFiles.length === 0) {
-        throw new WorkflowHistoryError(`No workflow artifacts found under ${WORKFLOW_DIR}. Run ph plan first.`);
+        throw new WorkflowHistoryError(`No workflow artifacts found under ${WORKFLOW_DIR}. Run npx ph plan first.`);
     }
     mkdirSync(archiveDir, { recursive: true });
     for (const filename of archivedFiles) {

package/dist/cli/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/cli/history.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/cli/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,OAAO,MAAM,cAAc,CAAA;AAyBlC,MAAM,oBAAqB,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED,MAAM,YAAY,GAAG,mBAAmB,CAAA;AACxC,MAAM,WAAW,GAAG,2BAA2B,CAAA;AAC/C,MAAM,kBAAkB,GAAgC;IACtD,EAAE,QAAQ,EAAE,SAAS,EAAE;IACvB,EAAE,QAAQ,EAAE,0BAA0B,EAAE;IACxC,EAAE,QAAQ,EAAE,kBAAkB,EAAE;CACjC,CAAA;AAED,MAAM,UAAU,YAAY,CAAC,UAAU,GAAG,IAAI;IAC5C,OAAO;QACL,UAAU,UAAU,8BAA8B;QAClD,EAAE;QACF,kEAAkE;QAClE,EAAE;QACF,QAAQ;QACR,KAAK,YAAY,UAAU;QAC3B,KAAK,YAAY,2BAA2B;QAC5C,KAAK,YAAY,mBAAmB;QACpC,EAAE;QACF,SAAS;QACT,KAAK,WAAW,gBAAgB;QAChC,EAAE;QACF,QAAQ;QACR,+BAA+B;QAC/B,yCAAyC;QACzC,qCAAqC;KACtC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAuB;IAC/C,IAAI,SAA6B,CAAA;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;QACzB,CAAC;QACD,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;YAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAA;YAC9D,CAAC;YACD,SAAS,GAAG,KAAK,CAAA;YACjB,KAAK,IAAI,CAAC,CAAA;YACV,SAAQ;QACV,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,GAAG,EAAE,EAAE,CAAA;IAC/D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AACnC,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,oBAAoB,CAAC,+EAA+E,CAAC,CAAA;IACjH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAS;IACjC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;AAChD,CAAC;AAED,SAAS,YAAY,CAAC,UAAkB,EAAE,QAAgB;IACxD,OAAO,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAA;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,MAA4B;IACjD,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,iBAAiB,MAAM,CAAC,SAAS,IAAI;QACrC,mBAAmB,MAAM,CAAC,UAAU,IAAI;QACxC,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,GAAG,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC;QAClC,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,GAAG,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC;QACjC,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,4CAA4C;QAC5C,sDAAsD;QACtD,wCAAwC;QACxC,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,SAAS,SAAS,CAAC,MAAyB;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,QAAQ,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAA0B,EAAE,EAAE,cAAuB;IAC1F,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAC/D,MAAM,SAAS,GAAG,cAAc,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAA;IAC/E,oBAAoB,CAAC,SAAS,CAAC,CAAA;IAE/B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;IAC3D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,oBAAoB,CAAC,GAAG,WAAW,IAAI,SAAS,kBAAkB,CAAC,CAAA;IAC/E,CAAC;IAED,MAAM,aAAa,GAAa,EAAE,CAAA;IAClC,MAAM,YAAY,GAAa,EAAE,CAAA;IACjC,KAAK,MAAM,QAAQ,IAAI,kBAAkB,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAC9D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACvC,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,oBAAoB,CAAC,qCAAqC,YAAY,0BAA0B,CAAC,CAAA;IAC7G,CAAC;IAED,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1C,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,YAAY,CAAC,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC9E,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA;IACrE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;IACpE,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAuB,EAAE,UAA0B,EAAE,EAAE,cAAc,GAAG,IAAI;IAC5G,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAErC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAC/E,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,OAAO,YAAY,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;IACpG,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;QAChE,OAAO;YACL,MAAM,EAAE,CAAC;YACT,MAAM,EAAE;gBACN,4CAA4C;gBAC5C,EAAE;gBACF,YAAY,MAAM,CAAC,UAAU,EAAE;gBAC/B,mBAAmB,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE;gBAChD,kBAAkB,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE;aAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI;YACnB,MAAM,EAAE,EAAE;SACX,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;YAC1C,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAA;QAChE,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/cli/init.js

@@ -155,7 +155,19 @@ export function formatInitResult(result) {
         ...backupLines,
         "",
         "Next:",
-        'opencode run --dir . --model openai/gpt-5.4-mini-fast "README.md를 끝까지 읽고, 요구사항 전체를 Gradle 기반 Spring 백엔드로 구현해줘."',
+        "1. Run `npx ph intake --interactive`.",
+        "2. Run `npx ph policy init` if you want company or personal backend guidance.",
+        "3. Run `npx ph plan`.",
+        "4. Review `.persona/workflow/plan.md`, then run `npx ph plan --accept` or `npx ph plan --revise`.",
+        "",
+        "OpenCode TUI:",
+        "- Run `opencode` in this project.",
+        "- Ask it to read README.md and `.persona/workflow/plan.md` first.",
+        "- Paste `npx ph plan --prompt` if you want the plan-only prompt inside the TUI.",
+        "",
+        "OpenCode CLI:",
+        "- Plan first: `opencode run --dir . --model <model> --dangerously-skip-permissions \"$(npx ph plan --prompt)\"`",
+        "- Implement only after the plan is accepted.",
         "",
         "Scope:",
         "- Java/Spring backend Clean Code injection",