@agent-native/core 0.100.2 → 0.101.3

package/corpus/core/docs/content/locales/ko-KR/pr-visual-recap.mdx

@@ -102,13 +102,13 @@ PR Visual Recap은 모든 끌어오기 요청을 **시각적 코드 검토**로
 npx @agent-native/core@latest skills add visual-plan --with-github-action
 ```
 
-이렇게 하면 `visual-plan` 스킬(액션이 실행하는 `visual-recap` 스킬 포함)이 설치되고 저장소에 `.github/workflows/pr-visual-recap.yml`가 기록됩니다. 워크플로는 `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check`를 포함하여 `npx @agent-native/core@latest recap <subcommand>`를 통해 **게시된 CLI 하위 명령**을 호출합니다. `usage` — 따라서 저장소에 도우미 스크립트로 복사되는 것은 없습니다. `setup` 및 `doctor`는 로컬에서 실행하는 대화형 도우미입니다. `gate`는 모든 요약 전에 워크플로가 실행되는 보안 게이트 단계입니다.
+이렇게 하면 `visual-plan` 스킬(액션이 실행하는 `visual-recap` 스킬 포함)이 설치되고 저장소에 `.github/workflows/pr-visual-recap.yml`가 기록됩니다. 워크플로는 `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check`를 포함하여 `npx @agent-native/recap-cli@latest recap <subcommand>`를 통해 **게시된 CLI 하위 명령**을 호출합니다. `usage` — 따라서 저장소에 도우미 스크립트로 복사되는 것은 없습니다. `setup` 및 `doctor`는 로컬에서 실행하는 대화형 도우미입니다. `gate`는 모든 요약 전에 워크플로가 실행되는 보안 게이트 단계입니다.
 
 그런 다음 안내식 설정 도우미를 실행하세요.
 
 ```bash
-npx @agent-native/core@latest recap setup
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 `recap setup`는 작업 흐름을 새로 고치고 `gh`를 사용하여 GitHub Actions를 설정합니다.
@@ -118,7 +118,7 @@ env 또는 로컬 계획에서 값을 사용할 수 있는 경우 비밀/변수
 생성된 워크플로 파일을 열고 PR을 열어 실행을 확인하세요.
 
 기본적으로 워크플로는 최신 번들에서 에이전트 프롬프트를 작성합니다.
-형제를 포함한 `@agent-native/core@latest`의 `visual-recap` 지침
+형제를 포함한 `@agent-native/recap-cli@latest`의 `visual-recap` 지침
 스킬과 함께 제공되는 참조 파일입니다. 저장소가 의도적으로 사용자 정의되고
 커밋된 `visual-recap` 폴더를 고정하고 저장소 변수를 설정합니다.
 `VISUAL_RECAP_SKILL_SOURCE=repo`.
@@ -135,8 +135,8 @@ env 또는 로컬 계획에서 값을 사용할 수 있는 경우 비밀/변수
 JSON 따옴표는 필수입니다. 이 값은 전체 `recap` 작업의 러너를 선택합니다. 안내식 설정 중 구성하려면 동일한 JSON 값을 `--runs-on`에 전달한 다음 `doctor`로 워크플로와 러너 가용성을 검증하세요.
 
 ```bash
-npx @agent-native/core@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 경량 게이트는 별도로 `ubuntu-latest`를 사용합니다. GitHub 호스팅 러너를 비활성화한 저장소는 `VISUAL_RECAP_GATE_RUNS_ON`을 JSON이 아닌 단일 일반 레이블로 설정하거나 `--gate-runs-on visual-recap-gate`를 사용할 수 있습니다. 사용자 지정 레이블은 같은 저장소의 `OWNER`, `MEMBER`, `COLLABORATOR` 작성자에게만 사용됩니다. 포크와 그 밖의 작성자는 `ubuntu-latest`로 강제되며 GitHub 호스팅 러너가 꺼져 있으면 예약되지 않을 수 있습니다. 전용이며 가능하면 임시인 러너를 사용하세요. 기본 게이트는 PR 트리를 체크아웃하지 않고 워크플로 로직과 PR 메타데이터를 평가합니다.
@@ -160,12 +160,30 @@ npx @agent-native/core@latest recap doctor
 
 백엔드 외에도 두 개의 저장소 변수가 에이전트 실행 *방법*을 조정합니다.
 
-- **`VISUAL_RECAP_MODEL`**는 CLI(`--model`)에 전달된 모델을 고정합니다. 예를 들어 Codex의 경우 `gpt-5.6-sol` 또는 Claude 모델 ID입니다. CLI 자체 기본 모델을 사용하려면 설정하지 않은 상태로 두세요.
+- **`VISUAL_RECAP_MODEL`**는 CLI(`--model`)에 전달되는 모델을 고정합니다 — 예를 들어 Codex의 경우 `gpt-5.6-luna`, Claude 모델 ID, 또는 DeepSeek의 경우 `deepseek-chat`입니다. `openai-compatible`에는 필수입니다. **Claude** 백엔드의 경우 설정하지 않으면 이제 `claude-sonnet-5`가 기본값이 됩니다. 다른 Claude 모델(더 저렴한 `claude-haiku-4-5` 등)을 사용하려면 변수를 명시적으로 설정하세요. **Codex** 백엔드의 경우 설정하지 않으면 Codex CLI 자체의 기본 모델이 사용됩니다.
 - **`VISUAL_RECAP_REASONING`**는 추론 깊이를 `none`, `minimal`, `low`, `medium`, `high` 또는 `xhigh`로 설정합니다. 이는 Codex 백엔드에 적용됩니다. Claude의 추론은 모델 중심이므로 이 변수는 무시됩니다.
 - **`VISUAL_RECAP_SKILL_SOURCE`**는 프롬프트 최신성을 제어합니다. `auto`/unset은 최신 번들 기술 지침을 사용하고 `repo`는 커밋된 저장소 로컬 `visual-recap` 기술 폴더에 고정합니다.
 
 예를 들어 GPT-5.6 Sol를 사용하여 Codex에 대한 요약을 실행하려면 저장소 변수 `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol` 및 `VISUAL_RECAP_REASONING=high`를 설정하세요.
 
+## 비용
+
+각 요약 실행은 저렴한 템플릿 요약이 아니라 실제 diff를 읽는 완전한 에이전틱 코딩 에이전트 세션이므로, 비용은 모델 선택과 실행 빈도에 따라 달라집니다:
+
+- **PR 푸시마다 전체 세션.** 기본 트리거는 `synchronize`에서 실행되므로, 10번 푸시된 PR은 에이전트를 10번 실행합니다.
+- 마지막 실행 이후의 커밋만이 아니라 **매번 전체 PR**을 대상으로 합니다 — 비용은 증분 diff 크기가 아니라 전체 PR 크기에 비례합니다.
+- **diff 입력은 약 600KB로 제한됩니다.** 이는 실행당 최악의 경우를 제한하지만, 큰 diff는 작은 diff보다 여전히 상당히 더 많은 비용이 듭니다.
+- **실패 시 자동 재시도가 한 번** 있으며, 일시적으로 실패한 실행의 비용을 대략 두 배로 늘릴 수 있습니다.
+
+비용을 줄이려면:
+
+- **더 저렴한 모델을 고정하세요.** Claude의 경우, 간단하거나 작은 저장소에는 `VISUAL_RECAP_MODEL=claude-haiku-4-5`를 설정하세요 — 가장 저렴한 Claude 등급입니다. `claude-sonnet-5`(기본값)는 균형 잡힌 등급입니다.
+- **더 저렴한 모델로 Codex로 전환하세요.** `VISUAL_RECAP_AGENT=codex`와 `VISUAL_RECAP_MODEL=gpt-5.6-luna`(가장 저렴한 GPT-5.6 등급) 또는 `gpt-5.6-terra`(중간 등급)를 설정하고, 추론 토큰 비용을 더 줄이려면 `VISUAL_RECAP_REASONING=low`를 설정하세요. 추론 깊이는 Codex에만 적용됩니다.
+- **더 저렴한 OpenAI 호환 제공업체를 지정하세요.** `VISUAL_RECAP_AGENT=openai-compatible`을 DeepSeek, Kimi 또는 다른 OpenAI 호환 엔드포인트를 대상으로 하는 `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY`와 함께 설정하세요.
+- **요약 빈도를 줄이세요.** 설치된 워크플로의 `on.pull_request.types`를 `[opened, synchronize, reopened, ready_for_review, closed]`에서 `[opened, ready_for_review, closed]`로 편집하면, 모든 푸시가 아니라 PR이 열릴 때와 병합될 때만 요약이 실행됩니다.
+
+각 실행은 실제로 소비한 비용을 기록합니다. 워크플로의 `recap usage` 단계가 게시된 계획에 토큰 및 비용 사용량을 첨부하므로, 추측하는 대신 실행별 실제 지출을 확인할 수 있습니다.
+
 ## 비밀 및 변수
 
 이를 저장소의 **설정 → 비밀 및 변수 → Actions**에서 설정하세요.
@@ -196,11 +214,11 @@ npx @agent-native/core@latest connect https://plan.agent-native.com --service-to
 
 **솔로: 개인 토큰은 여전히 작동합니다.** `npx @agent-native/core@latest connect`로 발행하세요
 Plans 앱에 반대합니다. 호스팅된 앱의 경우 로컬
-`npx @agent-native/core@latest recap setup`가 읽을 수 있는 게시 토큰 파일:
+`npx @agent-native/recap-cli@latest recap setup`가 읽을 수 있는 게시 토큰 파일:
 
 ```bash
 npx @agent-native/core@latest connect https://plan.agent-native.com --client codex
-npx @agent-native/core@latest recap setup
+npx @agent-native/recap-cli@latest recap setup
 ```
 
 수동 설정을 선호하는 경우 토큰을 GitHub 비밀번호에 붙여넣으세요. 사용
@@ -209,16 +227,16 @@ npx @agent-native/core@latest recap setup
 
 ### 선택 사항(기본값을 변경하는 경우에만)
 
-| 비밀/변수                | 기본값                          | 필요할 때                                                                                                                                           |
-| ------------------------ | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `OPENAI_API_KEY`         | —                               | 비밀. 대신 Codex로 요약을 실행하려면 `VISUAL_RECAP_AGENT=codex`와 함께 설정하세요.                                                                  |
-| `VISUAL_RECAP_AGENT`     | `claude`                        | 변수. 코딩 에이전트 백엔드(`claude` 또는 `codex`)를 선택합니다.                                                                                     |
-| `VISUAL_RECAP_MODEL`     | 각 CLI의 기본값                 | 변수입니다. 모델을 고정합니다. Codex의 경우 `gpt-5.6-sol` 또는 Claude 모델 ID입니다. Unset은 CLI 자체 기본값을 사용합니다.                          |
-| `VISUAL_RECAP_REASONING` | 각 모델의 기본값                | 변수입니다. 추론 깊이: `none`, `minimal`, `low`, `medium`, `high` 또는 `xhigh`. Codex 백엔드에 적용됩니다.                                          |
-| `RECAP_CLI_VERSION`      | `latest`                        | 변수입니다. 워크플로가 설치하는 `@agent-native/core` CLI 버전을 고정합니다. `1.5.0`. [Version pinning](#version-pinning-copy-variant)를 참조하세요. |
-| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com` | 비밀. 다른 출처에서 Plans 앱을 자체 호스팅하는 경우에만 해당됩니다.                                                                                 |
+| 비밀/변수                | 기본값                                                | 필요할 때                                                                                                                                                                                                                                                                             |
+| ------------------------ | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`         | —                                                     | 비밀. 대신 Codex로 요약을 실행하려면 `VISUAL_RECAP_AGENT=codex`와 함께 설정하세요.                                                                                                                                                                                                    |
+| `VISUAL_RECAP_AGENT`     | `claude`                                              | 변수. 코딩 에이전트 백엔드(`claude` 또는 `codex`)를 선택합니다.                                                                                                                                                                                                                       |
+| `VISUAL_RECAP_MODEL`     | Claude의 경우 `claude-sonnet-5`; 호환 백엔드에는 필수 | 변수입니다. OpenAI 호환 백엔드용 제공업체 모델 ID(해당 백엔드에서는 필수). Claude의 경우 설정하지 않으면 이제 `claude-sonnet-5`가 기본값입니다 — 재정의하려면 설정하세요. 예: 가장 저렴한 등급인 `claude-haiku-4-5`. Codex의 경우 설정하지 않으면 Codex CLI 자체 기본값이 사용됩니다. |
+| `VISUAL_RECAP_REASONING` | 각 모델의 기본값                                      | 변수입니다. 추론 깊이: `none`, `minimal`, `low`, `medium`, `high` 또는 `xhigh`. Codex 백엔드에 적용됩니다.                                                                                                                                                                            |
+| `RECAP_CLI_VERSION`      | `latest`                                              | 변수입니다. 워크플로가 설치하는 `@agent-native/recap-cli` CLI 버전을 고정합니다. `1.5.0`. [Version pinning](#version-pinning-copy-variant)를 참조하세요.                                                                                                                              |
+| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`                       | 비밀. 다른 출처에서 Plans 앱을 자체 호스팅하는 경우에만 해당됩니다.                                                                                                                                                                                                                   |
 
-워크플로는 도우미 CLI(이 모노레포 내의 로컬 소스, 다른 곳에 게시된 `@agent-native/core`)를 호출하는 방법을 자동으로 감지하므로 설정할 `RECAP_CLI` 변수가 없습니다.
+워크플로는 도우미 CLI(이 모노레포 내의 로컬 소스, 다른 곳에 게시된 `@agent-native/recap-cli`)를 호출하는 방법을 자동으로 감지하므로 설정할 `RECAP_CLI` 변수가 없습니다.
 
 ## 댓글의 인라인 스크린샷
 
@@ -359,9 +377,9 @@ GitHub Action은 호스팅되고 공유 가능한 PR 검토를 위해 설계되
 로컬 파일 모드에서 로컬로 동일한 도우미 흐름:
 
 ```bash
-npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
-npx @agent-native/core@latest recap scan --diff recap.diff
-npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
+npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
+npx @agent-native/recap-cli@latest recap scan --diff recap.diff
+npx @agent-native/recap-cli@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
 ```
 
 생성된 `recap-prompt.md`를 코딩 에이전트에 제공하세요. 로컬 파일 모드에서
@@ -391,7 +409,7 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
 
 ## 버전 고정(복사 변형) {#version-pinning-copy-variant}
 
-기본적으로 복사 변형 워크플로는 런타임에 `@agent-native/core@latest`를 설치하므로 모든 요약 실행이 자동으로 최신 CLI를 선택합니다. CI에 재현 가능한 도구가 필요한 경우 **`RECAP_CLI_VERSION`** 저장소 변수를 설정하여 설치된 버전을 고정하세요.
+기본적으로 복사 변형 워크플로는 런타임에 `@agent-native/recap-cli@latest`를 설치하므로 모든 요약 실행이 자동으로 최신 CLI를 선택합니다. CI에 재현 가능한 도구가 필요한 경우 **`RECAP_CLI_VERSION`** 저장소 변수를 설정하여 설치된 버전을 고정하세요.
 
 1. 저장소의 **설정 → 비밀 및 변수 → Actions → 변수**로 이동하세요.
 2. `1.5.0`와 같은 값을 사용하여 `RECAP_CLI_VERSION`라는 변수를 만듭니다.
@@ -402,7 +420,7 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
 
 ## 비밀 검사 허용 목록
 
-요약을 게시하기 전에 워크플로는 `npx @agent-native/core@latest recap scan`를 실행하여 차이점에서 가능성 있는 비밀을 감지합니다. diff가 알려진 비밀 패턴과 일치하는 PR은 설명 주석과 함께 차단됩니다. 요약은 게시되지 않으며 diff 콘텐츠는 코딩 에이전트로 전송되지 않습니다.
+요약을 게시하기 전에 워크플로는 `npx @agent-native/recap-cli@latest recap scan`를 실행하여 차이점에서 가능성 있는 비밀을 감지합니다. diff가 알려진 비밀 패턴과 일치하는 PR은 설명 주석과 함께 차단됩니다. 요약은 게시되지 않으며 diff 콘텐츠는 코딩 에이전트로 전송되지 않습니다.
 
 드물게 저장소에 의도적인 테스트 픽스처 또는 표면적으로 비밀 패턴과 유사한 비밀이 아닌 문자열(예: 테스트 파일의 픽스처 키)이 있습니다. 거짓 긍정을 억제하려면 저장소 루트에 `.github/recap-scan-allowlist`를 생성하세요.
 
@@ -436,7 +454,7 @@ EXAMPLE_API_KEY=placeholder-value
 
 ### 재사용 가능한 변형을 사용하는 이유는 무엇입니까?
 
-기본 설치 프로그램은 전체 ~360줄 워크플로 YAML를 저장소에 복사합니다(**복사** 옵션). 이는 실행되는 모든 라인을 감사해야 하는 에어 갭 저장소 또는 저장소에 적합한 선택입니다. 단점은 버그 수정 및 개선 사항이 사용자에게 전달되지 않는다는 것입니다. 각 릴리스 후에 `npx @agent-native/core@latest recap setup`를 수동으로 다시 실행해야 합니다.
+기본 설치 프로그램은 전체 ~360줄 워크플로 YAML를 저장소에 복사합니다(**복사** 옵션). 이는 실행되는 모든 라인을 감사해야 하는 에어 갭 저장소 또는 저장소에 적합한 선택입니다. 단점은 버그 수정 및 개선 사항이 사용자에게 전달되지 않는다는 것입니다. 각 릴리스 후에 `npx @agent-native/recap-cli@latest recap setup`를 수동으로 다시 실행해야 합니다.
 
 **재사용 가능** 옵션은 대신 ~20줄의 얇은 호출자를 작성합니다. `uses:`를 통해 `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml`에 위임합니다. 모든 호출자는 워크플로가 실행될 때 로컬 업데이트 없이 자동으로 최신 로직을 선택합니다.
 
@@ -449,7 +467,7 @@ EXAMPLE_API_KEY=placeholder-value
 
 ### 발신자 스니펫
 
-이것은 `npx @agent-native/core@latest recap setup --reusable`가 쓴 내용입니다(또는 수동으로 붙여넣을 수도 있습니다):
+이것은 `npx @agent-native/recap-cli@latest recap setup --reusable`가 쓴 내용입니다(또는 수동으로 붙여넣을 수도 있습니다):
 
 ```yaml
 name: PR Visual Recap
@@ -484,7 +502,7 @@ jobs:
       skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
       runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
       gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
-      # cli-version: "latest"  # pin to a specific @agent-native/core version
+      # cli-version: "latest"  # pin to a specific @agent-native/recap-cli version
 ```
 
 [Secrets and variables](#secrets-and-variables)에 설명된 것과 동일한 비밀 및 변수가 적용됩니다. 재사용 가능한 호출자는 전체 작업에 `VISUAL_RECAP_RUNS_ON`을 `runs-on`으로, 게이트에 `VISUAL_RECAP_GATE_RUNS_ON`을 단일 레이블 `gate-runs-on`으로 전달합니다. 생략하면 둘 다 `ubuntu-latest`를 사용합니다.
@@ -493,15 +511,15 @@ jobs:
 
 ```bash
 # 전체 복사본 대신 씬 호출자를 작성합니다.
-npx @agent-native/core@latest recap setup --reusable
+npx @agent-native/recap-cli@latest recap setup --reusable
 
 # 또는 재현성을 위해 고정된 참조를 사용합니다.
-npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
+npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
 ```
 
 두 변형 모두 `.github/workflows/pr-visual-recap.yml`에 워크플로를 작성합니다. 기존 워크플로가 이미 있고 다른 경우 명령은 거부하고 `--force`를 전달하여 덮어쓰라고 지시합니다.
 
-작성 후 평소처럼 `npx @agent-native/core@latest recap doctor`를 실행하여 비밀이 구성되었는지 확인하세요.
+작성 후 평소처럼 `npx @agent-native/recap-cli@latest recap doctor`를 실행하여 비밀이 구성되었는지 확인하세요.
 
 ### 버전 고정
 
@@ -511,7 +529,7 @@ npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
 uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
 ```
 
-`cli-version` 입력은 `@agent-native/core` CLI 버전이 워크플로 내에서 실행되는 것을 제어합니다. 최신 릴리스를 추적하려면 `"latest"`에 남겨두거나 완전한 재현성을 위해 버전 문자열(예: `"1.5.0"`)에 고정하세요.
+`cli-version` 입력은 `@agent-native/recap-cli` CLI 버전이 워크플로 내에서 실행되는 것을 제어합니다. 최신 릴리스를 추적하려면 `"latest"`에 남겨두거나 완전한 재현성을 위해 버전 문자열(예: `"1.5.0"`)에 고정하세요.
 
 ### workflow_call 이벤트 컨텍스트
 

package/corpus/core/docs/content/locales/ko-KR/template-plan.mdx

@@ -208,6 +208,13 @@ Codex, Claude 코드, Markdown 또는 붙여넣은 계획이 이미 존재하는
 **같은 계획의 하단에 있는 공개 질문** 양식을 작성하세요. 답변 및 전송
 에이전트가 기존 계획에 대한 개정을 시작합니다.
 
+## 비용 및 모델 선택
+
+계획이나 요약을 생성하는 것은 가벼운 템플릿 채우기가 아니라 코딩 에이전트의 LLM에 대해 완전한 에이전틱 세션을 실행하는 것이므로, 비용은 diff나 계획의 크기와 선택한 모델에 따라 달라집니다.
+
+- 앱 자체의 기본 채팅 모델은 Sonnet 5이며, 언제든지 **설정**에서 변경할 수 있습니다. Haiku는 더 저렴한 Claude 옵션이고, Luna는 GPT-5.6 계열에서 더 저렴한 옵션입니다.
+- GitHub Action의 자동화된 PR 요약은 인터랙티브 앱과 별도로 실행되며 자체 모델 및 비용 조정 옵션을 갖습니다. `VISUAL_RECAP_MODEL`, `VISUAL_RECAP_AGENT`, `VISUAL_RECAP_REASONING`에 대해서는 [PR Visual Recap](/docs/pr-visual-recap)를 참조하세요.
+
 ## 그것으로 무엇을 할 수 있나요
 
 - **구현 전 검토.** 다이어그램, 와이어프레임, 옵션 탭에 대한 React

package/corpus/core/docs/content/locales/pt-BR/pr-visual-recap.mdx

@@ -102,13 +102,13 @@ explicitamente a qualquer momento:
 npx @agent-native/core@latest skills add visual-plan --with-github-action
 ```
 
-Isso instala a habilidade `visual-plan` (que inclui a habilidade `visual-recap` que a ação executa) e grava `.github/workflows/pr-visual-recap.yml` em seu repositório. O fluxo de trabalho chama **subcomandos CLI publicados** por meio de `npx @agent-native/core@latest recap <subcommand>` — incluindo `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` e `usage` – portanto, nada é copiado em seu repositório como scripts auxiliares. `setup` e `doctor` são os auxiliares interativos que você executa localmente; `gate` é a etapa de segurança que o fluxo de trabalho executa antes de cada recapitulação.
+Isso instala a habilidade `visual-plan` (que inclui a habilidade `visual-recap` que a ação executa) e grava `.github/workflows/pr-visual-recap.yml` em seu repositório. O fluxo de trabalho chama **subcomandos CLI publicados** por meio de `npx @agent-native/recap-cli@latest recap <subcommand>` — incluindo `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` e `usage` – portanto, nada é copiado em seu repositório como scripts auxiliares. `setup` e `doctor` são os auxiliares interativos que você executa localmente; `gate` é a etapa de segurança que o fluxo de trabalho executa antes de cada recapitulação.
 
 Em seguida, execute o assistente de configuração guiada:
 
 ```bash
-npx @agent-native/core@latest recap setup
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 `recap setup` atualiza o fluxo de trabalho, usa `gh` para definir GitHub Actions
@@ -118,7 +118,7 @@ conjunto. Os valores secretos são enviados para `gh` por meio de stdin, não po
 o arquivo de fluxo de trabalho gerado e abra um PR para vê-lo ser executado.
 
 Por padrão, o fluxo de trabalho cria seu prompt de agente a partir do pacote mais recente
-Orientação `visual-recap` em `@agent-native/core@latest`, incluindo qualquer irmão
+Orientação `visual-recap` em `@agent-native/recap-cli@latest`, incluindo qualquer irmão
 arquivos de referência que acompanham a habilidade. Se o seu repositório for personalizado intencionalmente e
 fixa sua pasta `visual-recap` comprometida, defina a variável do repositório
 `VISUAL_RECAP_SKILL_SOURCE=repo`.
@@ -135,8 +135,8 @@ Por padrão, o fluxo de trabalho é executado em executores `ubuntu-latest` hosp
 As aspas JSON são obrigatórias. Esse valor seleciona o executor do trabalho completo `recap`. Para configurá-lo durante a instalação guiada, passe o mesmo valor JSON para `--runs-on` e depois valide o fluxo de trabalho e a disponibilidade do executor com `doctor`:
 
 ```bash
-npx @agent-native/core@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 O gate leve usa `ubuntu-latest` separadamente. Repositórios sem executores hospedados pelo GitHub podem definir `VISUAL_RECAP_GATE_RUNS_ON` como um único rótulo de texto simples, sem JSON, ou usar `--gate-runs-on visual-recap-gate`. O rótulo personalizado só vale para autores `OWNER`, `MEMBER` ou `COLLABORATOR` do mesmo repositório; forks e outros autores são forçados para `ubuntu-latest` e podem ficar sem agendamento se os executores hospedados estiverem desativados. Use um executor dedicado e, de preferência, efêmero: o gate padrão não baixa a árvore do PR e avalia a lógica do fluxo de trabalho e os metadados do PR.
@@ -160,12 +160,30 @@ Se a variável não estiver definida, a ação usará `claude`.
 
 Além do back-end, duas variáveis de repositório ajustam _como_ o agente é executado:
 
-- **`VISUAL_RECAP_MODEL`** fixa o modelo passado para CLI (`--model`) — por exemplo, `gpt-5.6-sol` para Codex ou um ID de modelo Claude. Deixe-o desativado para usar o modelo padrão do próprio CLI.
+- **`VISUAL_RECAP_MODEL`** fixa o modelo passado para CLI (`--model`) — por exemplo, `gpt-5.6-luna` para Codex, um ID de modelo Claude, ou `deepseek-chat` para DeepSeek. É obrigatória para `openai-compatible`. Para o back-end **Claude**, se a variável não estiver definida, o padrão agora é `claude-sonnet-5`; defina-a explicitamente para usar um modelo Claude diferente, como o mais barato `claude-haiku-4-5`. Para o back-end **Codex**, se não estiver definida, é usado o modelo padrão do próprio CLI do Codex.
 - **`VISUAL_RECAP_REASONING`** define a profundidade do raciocínio: `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. Aplica-se ao backend Codex; O raciocínio de Claude é baseado em modelo, então esta variável é ignorada lá.
 - **`VISUAL_RECAP_SKILL_SOURCE`** controla a atualização do prompt: `auto`/unset usa o pacote de orientação de habilidades mais recente, enquanto `repo` fixa-se à pasta de habilidades `visual-recap` do repositório local confirmado.
 
 Por exemplo, para executar a recapitulação em Codex com GPT-5.6 Sol com raciocínio alto, defina as variáveis de repositório `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol` e `VISUAL_RECAP_REASONING=high`.
 
+## Custo
+
+Cada execução de recapitulação é uma sessão completa de agente de codificação lendo um diff real, não um resumo barato baseado em modelo, então seu custo acompanha a escolha do modelo e a frequência com que é executada:
+
+- **Uma sessão completa por push no PR.** O gatilho padrão dispara em `synchronize`, então um PR que recebe dez pushes executa o agente dez vezes.
+- **O PR inteiro a cada vez**, não apenas os commits desde a última execução — o custo escala com o tamanho total do PR, não com o tamanho incremental do diff.
+- **Entrada do diff limitada a ~600KB.** Isso limita o pior caso por execução, mas diffs grandes ainda custam significativamente mais do que os pequenos.
+- **Uma nova tentativa automática em caso de falha**, o que pode aproximadamente dobrar o custo de uma execução que falha de forma transitória.
+
+Para reduzir o custo:
+
+- **Fixe um modelo mais barato.** Para Claude, defina `VISUAL_RECAP_MODEL=claude-haiku-4-5` para repositórios simples ou pequenos — é o nível Claude mais barato; `claude-sonnet-5` (o padrão) é o nível equilibrado.
+- **Mude para Codex com um modelo mais barato.** Defina `VISUAL_RECAP_AGENT=codex` com `VISUAL_RECAP_MODEL=gpt-5.6-luna` (o nível GPT-5.6 mais barato) ou `gpt-5.6-terra` (nível intermediário), e defina `VISUAL_RECAP_REASONING=low` para reduzir ainda mais o gasto com tokens de raciocínio. A profundidade de raciocínio só se aplica ao Codex.
+- **Aponte para um provedor mais barato compatível com OpenAI.** Defina `VISUAL_RECAP_AGENT=openai-compatible` com `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY` direcionados ao DeepSeek, Kimi ou qualquer outro endpoint compatível com OpenAI.
+- **Recapitule com menos frequência.** Edite o `on.pull_request.types` do fluxo de trabalho instalado de `[opened, synchronize, reopened, ready_for_review, closed]` para `[opened, ready_for_review, closed]` para que ele só recapitule quando um PR é aberto e quando é mesclado, em vez de a cada push.
+
+Cada execução registra o que realmente foi gasto: a etapa `recap usage` do fluxo de trabalho anexa o uso de tokens e custo ao plano publicado, para que você possa ver o gasto real por execução em vez de adivinhar.
+
 ## Segredos e variáveis
 
 Defina-os em **Configurações → Segredos e variáveis → Actions** do seu repositório.
@@ -196,11 +214,11 @@ Aplicativo Planos.
 
 **Solo: um token pessoal ainda funciona.** Crie-o com `npx @agent-native/core@latest connect`
 em seu aplicativo Planos. Para o aplicativo hospedado, isso também grava um local
-arquivo de token de publicação que `npx @agent-native/core@latest recap setup` pode ler:
+arquivo de token de publicação que `npx @agent-native/recap-cli@latest recap setup` pode ler:
 
 ```bash
 npx @agent-native/core@latest connect https://plan.agent-native.com --client codex
-npx @agent-native/core@latest recap setup
+npx @agent-native/recap-cli@latest recap setup
 ```
 
 Se preferir a configuração manual, cole o token no segredo GitHub. Utilize um
@@ -209,16 +227,16 @@ token real.
 
 ### Opcional (somente se você alterar os padrões)
 
-| Segredo/variável         | Padrão                          | Quando você precisar                                                                                                                                                |
-| ------------------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `OPENAI_API_KEY`         | —                               | Segredo. Defina junto com `VISUAL_RECAP_AGENT=codex` para executar a recapitulação com Codex.                                                                       |
-| `VISUAL_RECAP_AGENT`     | `claude`                        | Variável. Seleciona o back-end do agente de codificação (`claude` ou `codex`).                                                                                      |
-| `VISUAL_RECAP_MODEL`     | padrão de cada CLI              | Variável. Fixa o modelo - por ex. `gpt-5.6-sol` para Codex ou um ID de modelo Claude. Unset usa o próprio padrão do CLI.                                            |
-| `VISUAL_RECAP_REASONING` | padrão de cada modelo           | Variável. Profundidade de raciocínio: `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. Aplica-se ao back-end Codex.                                           |
-| `RECAP_CLI_VERSION`      | `latest`                        | Variável. Fixa a versão `@agent-native/core` CLI que o fluxo de trabalho instala - por exemplo. `1.5.0`. Consulte [Version pinning](#version-pinning-copy-variant). |
-| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com` | Segredo. Somente ao auto-hospedar o aplicativo Planos em uma origem diferente.                                                                                      |
+| Segredo/variável         | Padrão                                                                | Quando você precisar                                                                                                                                                                                                                                                                                                    |
+| ------------------------ | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`         | —                                                                     | Segredo. Defina junto com `VISUAL_RECAP_AGENT=codex` para executar a recapitulação com Codex.                                                                                                                                                                                                                           |
+| `VISUAL_RECAP_AGENT`     | `claude`                                                              | Variável. Seleciona o back-end do agente de codificação (`claude` ou `codex`).                                                                                                                                                                                                                                          |
+| `VISUAL_RECAP_MODEL`     | `claude-sonnet-5` para Claude; obrigatório para o back-end compatível | Variável. ID do modelo do provedor para back-ends compatíveis com OpenAI (obrigatório nesse caso). Para Claude, se não definida, o padrão agora é `claude-sonnet-5` — defina-a para substituir, por ex. `claude-haiku-4-5` para o nível mais barato. Para Codex, se não definida, usa o próprio padrão do CLI do Codex. |
+| `VISUAL_RECAP_REASONING` | padrão de cada modelo                                                 | Variável. Profundidade de raciocínio: `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. Aplica-se ao back-end Codex.                                                                                                                                                                                               |
+| `RECAP_CLI_VERSION`      | `latest`                                                              | Variável. Fixa a versão `@agent-native/recap-cli` CLI que o fluxo de trabalho instala - por exemplo. `1.5.0`. Consulte [Version pinning](#version-pinning-copy-variant).                                                                                                                                                |
+| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`                                       | Segredo. Somente ao auto-hospedar o aplicativo Planos em uma origem diferente.                                                                                                                                                                                                                                          |
 
-O fluxo de trabalho detecta automaticamente como invocar seu auxiliar CLI (fonte local dentro deste monorepo, o `@agent-native/core` publicado em outro lugar), portanto, não há variável `RECAP_CLI` a ser definida.
+O fluxo de trabalho detecta automaticamente como invocar seu auxiliar CLI (fonte local dentro deste monorepo, o `@agent-native/recap-cli` publicado em outro lugar), portanto, não há variável `RECAP_CLI` a ser definida.
 
 ## Captura de tela embutida no comentário
 
@@ -359,9 +377,9 @@ recapitular sem enviar conteúdo de recapitulação para o banco de dados do Pla
 mesmo fluxo auxiliar localmente no modo de arquivos locais:
 
 ```bash
-npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
-npx @agent-native/core@latest recap scan --diff recap.diff
-npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
+npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
+npx @agent-native/recap-cli@latest recap scan --diff recap.diff
+npx @agent-native/recap-cli@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
 ```
 
 Entregue o `recap-prompt.md` gerado ao seu agente de codificação. No modo de arquivos locais
@@ -391,7 +409,7 @@ A recapitulação é um auxílio de revisão que se sobrepõe ao fluxo normal de
 
 ## Fixação de versão (variante de cópia) {#version-pinning-copy-variant}
 
-Por padrão, o fluxo de trabalho da variante de cópia instala o `@agent-native/core@latest` em tempo de execução para que cada execução de recapitulação selecione automaticamente o CLI mais recente. Se seu CI precisar de ferramentas reproduzíveis, defina a variável de repositório **`RECAP_CLI_VERSION`** para fixar a versão instalada:
+Por padrão, o fluxo de trabalho da variante de cópia instala o `@agent-native/recap-cli@latest` em tempo de execução para que cada execução de recapitulação selecione automaticamente o CLI mais recente. Se seu CI precisar de ferramentas reproduzíveis, defina a variável de repositório **`RECAP_CLI_VERSION`** para fixar a versão instalada:
 
 1. Vá para **Configurações → Segredos e variáveis → Actions → Variáveis** do seu repositório.
 2. Crie uma variável chamada `RECAP_CLI_VERSION` com um valor como `1.5.0`.
@@ -402,7 +420,7 @@ Para a variante do chamador reutilizável, use a entrada `cli-version` (consulte
 
 ## Lista de permissões de verificação secreta
 
-Antes de publicar uma recapitulação, o fluxo de trabalho executa `npx @agent-native/core@latest recap scan` para detectar prováveis segredos na comparação. Qualquer PR cuja comparação corresponda a um padrão de segredo conhecido é bloqueado com um comentário explicativo — a recapitulação não é publicada e nenhum conteúdo de comparação é enviado ao agente de codificação.
+Antes de publicar uma recapitulação, o fluxo de trabalho executa `npx @agent-native/recap-cli@latest recap scan` para detectar prováveis segredos na comparação. Qualquer PR cuja comparação corresponda a um padrão de segredo conhecido é bloqueado com um comentário explicativo — a recapitulação não é publicada e nenhum conteúdo de comparação é enviado ao agente de codificação.
 
 Em casos raros, um repositório possui acessórios de teste intencionais ou strings não secretas que se assemelham superficialmente a padrões secretos (por exemplo, uma chave de acessório em um arquivo de teste). Para suprimir um falso positivo, crie `.github/recap-scan-allowlist` na raiz do seu repositório.
 
@@ -436,7 +454,7 @@ A lista de permissões só é consultada pelo portão de varredura secreta. Isso
 
 ### Por que usar a variante reutilizável?
 
-O instalador padrão copia o fluxo de trabalho completo de aproximadamente 360 linhas YAML em seu repositório (a opção **copiar**). Esta é a escolha certa para repositórios isolados ou repositórios que precisam auditar cada linha do que é executado. A desvantagem é que as correções de bugs e melhorias nunca chegam até você – você precisa executar novamente o `npx @agent-native/core@latest recap setup` manualmente após cada lançamento.
+O instalador padrão copia o fluxo de trabalho completo de aproximadamente 360 linhas YAML em seu repositório (a opção **copiar**). Esta é a escolha certa para repositórios isolados ou repositórios que precisam auditar cada linha do que é executado. A desvantagem é que as correções de bugs e melhorias nunca chegam até você – você precisa executar novamente o `npx @agent-native/recap-cli@latest recap setup` manualmente após cada lançamento.
 
 A opção **reutilizável** grava um chamador fino de aproximadamente 20 linhas. Delega para `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` via `uses:`. Cada chamador seleciona automaticamente a lógica mais recente quando o fluxo de trabalho é executado, sem necessidade de atualização local.
 
@@ -449,7 +467,7 @@ A opção **reutilizável** grava um chamador fino de aproximadamente 20 linhas.
 
 ### Snippet do autor da chamada
 
-Isso é o que `npx @agent-native/core@latest recap setup --reusable` escreve (ou você pode colá-lo manualmente):
+Isso é o que `npx @agent-native/recap-cli@latest recap setup --reusable` escreve (ou você pode colá-lo manualmente):
 
 ```yaml
 name: PR Visual Recap
@@ -484,7 +502,7 @@ jobs:
       skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
       runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
       gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
-      # cli-version: "latest"  # pin to a specific @agent-native/core version
+      # cli-version: "latest"  # pin to a specific @agent-native/recap-cli version
 ```
 
 Aplicam-se os mesmos segredos e variáveis descritos em [Secrets and variables](#secrets-and-variables). O chamador reutilizável encaminha `VISUAL_RECAP_RUNS_ON` como `runs-on` para o trabalho completo e `VISUAL_RECAP_GATE_RUNS_ON` como o rótulo simples `gate-runs-on` para o gate. Ambos usam `ubuntu-latest` quando omitidos.
@@ -493,15 +511,15 @@ Aplicam-se os mesmos segredos e variáveis descritos em [Secrets and variables](
 
 ```bash
 # Escreva o chamador thin em vez da cópia completa:
-npx @agent-native/core@latest recap setup --reusable
+npx @agent-native/recap-cli@latest recap setup --reusable
 
 # Ou com uma referência fixada para reprodutibilidade:
-npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
+npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
 ```
 
 Ambas as variantes gravam o fluxo de trabalho em `.github/workflows/pr-visual-recap.yml`. Se um fluxo de trabalho existente já existir e for diferente, o comando recusará e solicitará que você passe `--force` para substituição.
 
-Depois de escrever, execute `npx @agent-native/core@latest recap doctor` normalmente para confirmar se os segredos estão configurados.
+Depois de escrever, execute `npx @agent-native/recap-cli@latest recap doctor` normalmente para confirmar se os segredos estão configurados.
 
 ### Fixação de versão
 
@@ -511,7 +529,7 @@ Por padrão, o chamador faz referência a `@main`, que sempre usa a versão publ
 uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
 ```
 
-A entrada `cli-version` controla qual versão do `@agent-native/core` CLI é executada dentro do fluxo de trabalho. Deixe-a em `"latest"` para rastrear a versão mais recente ou fixe-a em uma string de versão (por exemplo, `"1.5.0"`) para reprodutibilidade total.
+A entrada `cli-version` controla qual versão do `@agent-native/recap-cli` CLI é executada dentro do fluxo de trabalho. Deixe-a em `"latest"` para rastrear a versão mais recente ou fixe-a em uma string de versão (por exemplo, `"1.5.0"`) para reprodutibilidade total.
 
 ### contexto do evento workflow_call
 

package/corpus/core/docs/content/locales/pt-BR/template-plan.mdx

@@ -214,6 +214,20 @@ Se a primeira passagem ainda tiver decisões responsáveis, o agente pode fazer
 **Formulário de perguntas abertas** na parte inferior do mesmo plano. Respondendo e enviando
 o agente inicia uma revisão do plano existente.
 
+## Custo e escolha do modelo
+
+Gerar um plano ou uma recapitulação executa uma sessão completa de agente contra
+o LLM do seu agente de codificação, não um preenchimento leve de modelo, então o
+custo escala com o tamanho do diff ou do plano e o modelo que você escolher.
+
+- O modelo de chat padrão do próprio aplicativo é o Sonnet 5; altere-o a qualquer
+  momento em **Configurações**. Haiku é a opção Claude mais barata, e Luna é a
+  opção mais barata da família GPT-5.6.
+- As recapitulações automáticas de PR da GitHub Action são executadas
+  separadamente do aplicativo interativo e têm seus próprios controles de
+  modelo e custo — veja [PR Visual Recap](/docs/pr-visual-recap) para
+  `VISUAL_RECAP_MODEL`, `VISUAL_RECAP_AGENT` e `VISUAL_RECAP_REASONING`.
+
 ## O que você pode fazer com isso
 
 - **Revisão antes da implementação.** React para diagramas, wireframes, guias de opções,