persona-harness 0.8.21 → 0.8.23

package/README.ko.md

@@ -1,163 +0,0 @@
-<!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
-
-<div align="center">
-
-<img src="img/Persona-Harness-Logo.png" alt="Persona Harness 로고" width="180">
-
-# Persona Harness
-
-**Java/Spring 백엔드를 만드는 AI 코딩 에이전트를 위한 완료 게이트.**
-
-[![npm version](https://img.shields.io/npm/v/persona-harness?color=369eff&labelColor=black&style=flat-square)](https://www.npmjs.com/package/persona-harness)
-[![npm downloads](https://img.shields.io/npm/dt/persona-harness?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/persona-harness)
-[![node](https://img.shields.io/badge/node-%5E20.17.0%20%7C%7C%20%3E%3D22.9.0-c4f042?labelColor=black&style=flat-square)](https://nodejs.org)
-[![License](https://img.shields.io/badge/license-Apache--2.0-white?labelColor=black&style=flat-square)](./LICENSE)
-
-[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
-
-**[Start Here](docs/START-HERE.md) · [Quick Demo](docs/QUICK-DEMO.md) · [Measured Claims](docs/MEASURED-CLAIMS.md)**
-
-</div>
-
-<!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
-
-> AI 에이전트는 "다 됐습니다!"라고 말하기를 좋아합니다 — Persona Harness는 그것을 증명하게 만듭니다. 필요한 report, PH가 생성한 evidence, 실제 테스트 결과가 디스크에 존재하기 전까지 완료 주장을 차단하는 로컬 CLI 완료 게이트입니다.
-
-> [!IMPORTANT]
-> **Alpha, gate-first, 측정 기반.** 라이브 registry 채널, 태그, GitHub 릴리스와 audit lifecycle fact는 governed registry와 audit record에 유지됩니다. source 문서는 자신의 preparation boundary만 기록합니다. runtime injection은 **default-off / opt-in**입니다. [`docs/current/p3-integrity-roadmap.md`](docs/current/p3-integrity-roadmap.md), [`docs/MEASURED-CLAIMS.md`](docs/MEASURED-CLAIMS.md), [`injection-value-status.json`](docs/current/injection-value-status.json)을 참고하세요.
-
-## 측정된 동작 (Measured Behavior)
-
-대부분의 에이전트 하네스 프로젝트와 달리, PH는 실제로 측정한 것을 — 부정적 결과까지 — 공개합니다.
-
-- **위조된 TDD evidence**를 `workflow finish` 전에 심음 → `finish`가 **exit 1**, 위조 파일 무시.
-- **Green-only 완료**(TDD rail on) → 차단 **5/5** (off일 때는 허용 5/5).
-- **runtime injection**, 10쌍 OpenCode run → 성공률 동일(둘 다 10/10)이지만 PH ON이 10쌍 전부 비용 증가 → **default-off** 유지.
-
-제한된 로컬 fixture에서의 completion-integrity 측정입니다 — 토큰 절약/앱 품질/제품 효능 주장이 *아닙니다*. 전체 경계와 근거: **[docs/MEASURED-CLAIMS.md](docs/MEASURED-CLAIMS.md)**.
-
-## 이게 뭔가요
-
-AI 에이전트가 수행하는 Java/Spring 백엔드 작업을 위한 workflow + evidence CLI(`ph`)와 선택적 OpenCode 플러그인입니다. 하는 일:
-
-- 프로젝트 아이디어나 README를 구현 ticket으로 분할
-- 에이전트를 반복 가능한 백엔드 workflow 위에 유지
-- 제한된 명령 실행으로 검증
-- 무엇을 읽고 실행하고 완료했는지 로컬 evidence로 기록
-- **필요한 report/evidence가 없으면 완료를 차단**
-
-코드 품질 보장, 토큰 절약 제품, broad linter, generated app이 production-ready라는 증명이 **아닙니다**. 완료 게이트보다 넓은 모든 주장은 먼저 측정으로 획득해야 합니다 — [MEASURED-CLAIMS](docs/MEASURED-CLAIMS.md) 참고.
-
-## 설치
-
-Node.js ^20.17.0 || >=22.9.0 (Node 21은 지원하지 않음), Java 21+ / Gradle, 그리고 프로바이더가 설정된 OpenCode CLI가 필요합니다.
-
-```bash
-# OpenCode
-curl -fsSL https://opencode.ai/install | bash   # 또는: npm install -g opencode-ai
-opencode auth login
-
-# Persona Harness
-npm install -D persona-harness
-npx ph --help && npx ph doctor
-```
-
-## 빠른 시작
-
-깨끗한 프로젝트 디렉터리에서는 다음 경로를 사용하세요 (Persona Harness repo 자체 금지).
-
-```bash
-mkdir -p /tmp/ph-demo && cd /tmp/ph-demo && npm init -y
-npm install -D persona-harness
-
-npx ph init                 # 최소 통합 파일만 생성
-npx ph bootstrap backend    # AGENTS.md, profile, plan, report 템플릿
-npx ph workflow check
-```
-
-기존 Java/Spring/Gradle 프로젝트에서는 먼저 추론된 draft를 확인한 뒤 명시적으로
-승인하세요.
-
-```bash
-npx ph attach
-npx ph attach --yes
-
-# 인식된 약한 Persona Harness 설치에만 사용하며, ready 설치에는 사용하지 않음:
-npx ph attach --repair --yes
-```
-
-`attach`는 인식되지 않았거나 손상된 기존 Persona Harness 파일을 덮어쓰지 않고
-거부하며, 이미 ready인 설치의 repair도 거부합니다. 성공한 attach는 PH-run
-verification을 켜되 `runtimeInjection`, `systemConstitution`,
-`idleContinuation`, Ralph loop는 끈 상태로 유지합니다.
-
-그다음 OpenCode에서 에이전트에게 당신의 `README.md`를 구현하도록 요청하세요. 에이전트는 스스로 rail을 돌리고 `npx ph workflow finish implement`로 끝내야 합니다.
-
-> [!NOTE]
-> `workflow finish`가 실패하면 에이전트는 완료를 주장하기 전에 보고된 blocker를 고쳐야 합니다. **그 실패는 버그가 아니라 제품이 작동하는 것입니다.**
-
-샘플 Todo API와 아이디어-우선 흐름을 포함한 전체 안내: **[Quick Demo](docs/QUICK-DEMO.md)**.
-
-## TDD Rail (opt-in)
-
-`.persona/harness.jsonc`에서 두 설정을 모두 켭니다:
-
-```json
-{ "enforce": { "executeVerification": true, "tdd": true } }
-```
-
-그러면 `ph workflow test`는 **PH가 직접 실행한 Gradle/JUnit 실패로부터만** red evidence를 기록합니다 — 에이전트가 보고한 evidence는 절대 받지 않습니다. 이후 `workflow check` / `archive` / `finish`가 같은 ticket/test id의 green evidence를 기록합니다. red-first 완료 게이트이며, 테스트 scaffolding·충분성 증명·coverage/mutation·앱 품질 인증은 하지 않습니다.
-
-## 명령
-
-```bash
-npx ph attach [--yes]                                  # 기존 Java/Spring/Gradle 프로젝트
-npx ph workflow check | implement | finish implement | archive <ticket-id>
-npx ph workflow split README.md && npx ph workflow next   # 멀티 ticket
-npx ph bearshell --shell 'gradle test'                    # 제한된 실행
-npx ph evidence summary | metrics --json | ab-report --json | pminus-report --json
-npx ph review backend-shape
-```
-
-전체 목록은 `npx ph --help`. workflow 장부는 `.persona/workflow/`(`work/`, `history/`, `requirements/`)에 있습니다.
-
-## 선택적 통합 (opt-in preview)
-
-```bash
-npx ph bootstrap backend --codegraph-preview          # CodeGraph
-npx ph bootstrap backend --lsp-preview                # Java LSP
-npx ph bootstrap backend --runtime-injection-preview  # parked model-facing guidance
-npx ph bootstrap backend --no-developer-mcp           # 기본 developer MCP 비활성화
-```
-
-preview wrapper는 외부 도구가 없으면 성공을 위조하지 않고 **unavailable** 상태를 보고합니다. runtime injection은 parked(negative 측정)이며 권장 경로가 아닙니다.
-
-## 플랫폼 및 호스트 지원
-
-| 표면 | 상태 | 근거 범위 |
-| --- | --- | --- |
-| macOS / Linux + OpenCode | 검증됨 | 현재 Persona Harness 호스트 어댑터와 제품 근거는 macOS/Linux의 OpenCode에 한정됩니다. |
-| Windows | 미검증 | Windows 지원 주장은 없습니다. 잠금 identity의 device/inode 동작과 stale-lock/concurrency 결론은 측정되거나 검증되지 않았습니다. |
-| Codex 어댑터 | 계획됨 | 현재 Codex 어댑터나 Codex 제품 근거는 없습니다. 계획된 어댑터일 뿐입니다. |
-
-## 경계와 안전
-
-Evidence는 하나의 질문에만 답합니다 — *"에이전트가 기대된 rail을 보고 따랐는가?"* — 그 이상은 아닙니다. PH는 앱 품질 인증, 토큰 절약, Clean Code 보장, broad AST/linter 강제, full TDD 프레임워크, closure 보장, OpenCode 없는 완전한 workflow를 **약속하지 않습니다**. 정본 목록은 [MEASURED-CLAIMS](docs/MEASURED-CLAIMS.md)에 있습니다.
-
-> [!WARNING]
-> `ph bearshell`은 **샌드박스가 아닙니다**. 실행 시간과 출력 크기를 제한하지만, 명령은 여전히 당신의 머신에서 당신의 권한으로 실행됩니다. [SECURITY](SECURITY.md) 참고.
-
-## 문서
-
-- **새 사용자** → [Start Here](docs/START-HERE.md) · [Quick Demo](docs/QUICK-DEMO.md) · [Measured Claims](docs/MEASURED-CLAIMS.md)
-- **설치 & 백엔드 형태** → [MVP 설치 가이드](docs/current/java-backend-mvp-install-guide.md)
-- **기여자** → [CONTRIBUTING](CONTRIBUTING.md) · [ROADMAP](ROADMAP.md) · [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md)
-- **릴리스 & 측정** → [릴리스 운영](docs/current/release/README.md) · [버전별 릴리스 문서](docs/releases/README.md) · [패키지 인덱스](docs/releases/package-index.md) · [Changelog](CHANGELOG.md)
-
-## 기여
-
-기여를 환영합니다 — 부정적 측정 결과도 포함해서요. PH는 증거가 뒷받침하는 것만 주장하며, 주장을 넓히는 PR은 그 측정을 함께 가져와야 합니다. [CONTRIBUTING.md](CONTRIBUTING.md)부터 읽어주세요.
-
-## 라이선스
-
-Apache-2.0. [LICENSE](LICENSE)를 보세요.

package/README.zh-cn.md

@@ -1,162 +0,0 @@
-<!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
-
-<div align="center">
-
-<img src="img/Persona-Harness-Logo.png" alt="Persona Harness 标志" width="180">
-
-# Persona Harness
-
-**为构建 Java/Spring 后端的 AI 编码智能体提供的完成门禁。**
-
-[![npm version](https://img.shields.io/npm/v/persona-harness?color=369eff&labelColor=black&style=flat-square)](https://www.npmjs.com/package/persona-harness)
-[![npm downloads](https://img.shields.io/npm/dt/persona-harness?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/persona-harness)
-[![node](https://img.shields.io/badge/node-%5E20.17.0%20%7C%7C%20%3E%3D22.9.0-c4f042?labelColor=black&style=flat-square)](https://nodejs.org)
-[![License](https://img.shields.io/badge/license-Apache--2.0-white?labelColor=black&style=flat-square)](./LICENSE)
-
-[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
-
-**[Start Here](docs/START-HERE.md) · [Quick Demo](docs/QUICK-DEMO.md) · [Measured Claims](docs/MEASURED-CLAIMS.md)**
-
-</div>
-
-<!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
-
-> AI 智能体总喜欢说"完成了！"—— Persona Harness 让它们拿出证明。这是一个本地 CLI 完成门禁：在所需 report、由 PH 生成的 evidence、真实测试结果落盘之前，阻止任何完成声明。
-
-> [!IMPORTANT]
-> **Alpha，gate-first，基于测量。** 实时 registry 渠道、标签、GitHub 发布和 audit lifecycle 事实保存在 governed registry 与 audit record 中；source documentation 只记录自己的 preparation boundary。runtime injection 保持 **default-off / opt-in**。见 [`docs/current/p3-integrity-roadmap.md`](docs/current/p3-integrity-roadmap.md)、[`docs/MEASURED-CLAIMS.md`](docs/MEASURED-CLAIMS.md) 和 [`injection-value-status.json`](docs/current/injection-value-status.json)。
-
-## 已测量的行为 (Measured Behavior)
-
-与大多数智能体 harness 项目不同，PH 公开它实际测量过的东西 —— 包括负面结果。
-
-- **伪造的 TDD evidence** 在 `workflow finish` 前放置 → `finish` 以 **exit 1** 退出，伪造文件被忽略。
-- **Green-only 完成**（TDD rail 开启）→ 拦截 **5/5**（关闭时放行 5/5）。
-- **runtime injection**，10 组配对 OpenCode run → 成功率相同（都 10/10），但 PH ON 在全部 10 组都增加成本 → 保持 **default-off**。
-
-这些是在受限本地 fixture 上的 completion-integrity 测量 —— *不是* token 节省、应用质量或产品效能的主张。完整边界与依据：**[docs/MEASURED-CLAIMS.md](docs/MEASURED-CLAIMS.md)**。
-
-## 这是什么
-
-为 AI 智能体执行的 Java/Spring 后端工作提供的 workflow + evidence CLI（`ph`），以及可选的 OpenCode 插件。它：
-
-- 把项目想法或 README 拆分为实现 ticket
-- 让智能体保持在可重复的后端 workflow 上
-- 通过受限命令执行验证
-- 以本地 evidence 记录读取、执行、完成了什么
-- **缺少必需的 report/evidence 时阻止完成**
-
-它**不是**代码质量保证、token 节省产品、broad linter，也不是生成应用达到 production-ready 的证明。任何比完成门禁更宽的主张都必须先通过测量获得 —— 见 [MEASURED-CLAIMS](docs/MEASURED-CLAIMS.md)。
-
-## 安装
-
-需要 Node.js ^20.17.0 || >=22.9.0（不支持 Node 21）、Java 21+ / Gradle，以及已配置供应商的 OpenCode CLI。
-
-```bash
-# OpenCode
-curl -fsSL https://opencode.ai/install | bash   # 或：npm install -g opencode-ai
-opencode auth login
-
-# Persona Harness
-npm install -D persona-harness
-npx ph --help && npx ph doctor
-```
-
-## 快速开始
-
-对于干净的项目目录，请使用以下路径（不要用 Persona Harness 仓库本身）。
-
-```bash
-mkdir -p /tmp/ph-demo && cd /tmp/ph-demo && npm init -y
-npm install -D persona-harness
-
-npx ph init                 # 仅创建最小集成文件
-npx ph bootstrap backend    # AGENTS.md、profile、plan、report 模板
-npx ph workflow check
-```
-
-对于已有的 Java/Spring/Gradle 项目，先查看推断出的 draft，再明确接受它：
-
-```bash
-npx ph attach
-npx ph attach --yes
-
-# 仅用于已识别的弱 Persona Harness 安装，不能用于 ready 安装：
-npx ph attach --repair --yes
-```
-
-`attach` 会拒绝未识别或已损坏的现有 Persona Harness 文件，而不会覆盖它们。
-它也会拒绝修复已经 ready 的安装。成功 attach 会启用 PH-run verification，
-同时保持 `runtimeInjection`、`systemConstitution`、`idleContinuation` 和
-Ralph loop 为关闭状态。
-
-然后在 OpenCode 中请求智能体实现你的 `README.md`。它应当自行驱动 rail，并以 `npx ph workflow finish implement` 结束。
-
-> [!NOTE]
-> 如果 `workflow finish` 失败，智能体必须先修复报告的 blocker，才能声明完成。**这个失败不是 bug，而是产品在正常工作。**
-
-包含示例 Todo API 和想法优先流程的完整指南：**[Quick Demo](docs/QUICK-DEMO.md)**。
-
-## TDD Rail（opt-in）
-
-在 `.persona/harness.jsonc` 中同时启用两个设置：
-
-```json
-{ "enforce": { "executeVerification": true, "tdd": true } }
-```
-
-之后 `ph workflow test` **只从 PH 直接运行的 Gradle/JUnit 失败中**记录 red evidence —— 绝不接受智能体自行报告的 evidence。随后 `workflow check` / `archive` / `finish` 为同一 ticket/test id 记录 green evidence。这是 red-first 完成门禁；它不做测试脚手架、不证明测试充分性、不运行 coverage/mutation、不认证应用质量。
-
-## 命令
-
-```bash
-npx ph attach [--yes]                                  # 已有 Java/Spring/Gradle 项目
-npx ph workflow check | implement | finish implement | archive <ticket-id>
-npx ph workflow split README.md && npx ph workflow next   # 多 ticket
-npx ph bearshell --shell 'gradle test'                    # 受限执行
-npx ph evidence summary | metrics --json | ab-report --json | pminus-report --json
-npx ph review backend-shape
-```
-
-完整列表见 `npx ph --help`。workflow 账本位于 `.persona/workflow/`（`work/`、`history/`、`requirements/`）。
-
-## 可选集成（opt-in preview）
-
-```bash
-npx ph bootstrap backend --codegraph-preview          # CodeGraph
-npx ph bootstrap backend --lsp-preview                # Java LSP
-npx ph bootstrap backend --runtime-injection-preview  # parked 面向模型的 guidance
-npx ph bootstrap backend --no-developer-mcp           # 禁用默认 developer MCP
-```
-
-preview wrapper 在外部工具缺失时报告 **unavailable** 状态，而不是伪造成功。runtime injection 处于 parked（测为负面），不是推荐路径。
-
-## 平台与主机支持
-
-| 适用面 | 状态 | 证据边界 |
-| --- | --- | --- |
-| macOS / Linux + OpenCode | 已验证 | 当前 Persona Harness 的主机适配器和产品证据仅限于 macOS/Linux 上的 OpenCode。 |
-| Windows | 未验证 | 不主张 Windows 支持。锁 identity 的 device/inode 行为以及 stale-lock/concurrency 结论尚未测量或验证。 |
-| Codex 适配器 | 计划中 | 当前没有 Codex 适配器或 Codex 产品证据；它仅是计划中的适配器。 |
-
-## 边界与安全
-
-Evidence 只回答一个问题 —— *"智能体是否看到并遵循了预期的 rail？"* —— 仅此而已。PH **不**承诺应用质量认证、token 节省、Clean Code 保证、broad AST/linter 强制、full TDD 框架、closure 保证，或没有 OpenCode 的完整 workflow。规范列表见 [MEASURED-CLAIMS](docs/MEASURED-CLAIMS.md)。
-
-> [!WARNING]
-> `ph bearshell` **不是沙箱**。它限制运行时间和输出大小，但命令仍以你的权限在你的机器上执行。见 [SECURITY](SECURITY.md)。
-
-## 文档
-
-- **新用户** → [Start Here](docs/START-HERE.md) · [Quick Demo](docs/QUICK-DEMO.md) · [Measured Claims](docs/MEASURED-CLAIMS.md)
-- **安装 & 后端形态** → [MVP 安装指南](docs/current/java-backend-mvp-install-guide.md)
-- **贡献者** → [CONTRIBUTING](CONTRIBUTING.md) · [ROADMAP](ROADMAP.md) · [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md)
-- **发布 & 测量** → [发布运营](docs/current/release/README.md) · [版本化发布文档](docs/releases/README.md) · [包索引](docs/releases/package-index.md) · [Changelog](CHANGELOG.md)
-
-## 贡献
-
-欢迎贡献 —— 包括负面的测量结果。PH 只主张有证据支撑的东西，扩大主张的 PR 必须附带相应的测量。请从 [CONTRIBUTING.md](CONTRIBUTING.md) 开始。
-
-## 许可证
-
-Apache-2.0。见 [LICENSE](LICENSE)。