@yoonion/mimi-seed-mcp 0.20.0 → 0.21.1

package/README.md

@@ -134,12 +134,12 @@ export ANTHROPIC_API_KEY=sk-ant-...
 <!-- generated:readme-tools-table:start — edit scripts/docs-spec.mjs, then npm run plugin:sync -->
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
-| App Store Connect | 64 | `appstore_submit_for_review` / `appstore_get_weekly_insight` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
-| Google Play | 39 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
+| App Store Connect | 63 | `appstore_submit_for_review` / `appstore_get_weekly_insight` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
+| Google Play | 38 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
 | Firebase | 21 | `firebase_create_project` / `firebase_get_remote_config_overview` / `firebase_get_android_config` / `firebase_create_ios_app` |
 | AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
 | CI (GitHub Actions / GitLab) | 6 | `ci_trigger_build` / `ci_get_build_status` / `ci_list_workflows` / `ci_cancel_build` |
-| Jenkins (크리덴셜 + 잡) | 10 | `jenkins_create_credential` / `jenkins_upload_keystore` / `jenkins_create_job` / `jenkins_update_job` |
+| Jenkins (크리덴셜 + 잡 + 빌드) | 13 | `jenkins_create_credential` / `jenkins_upload_keystore` / `jenkins_create_job` / `jenkins_update_job` / `jenkins_trigger_build` |
 | GA4 (Google Analytics 4) | 8 | `ga4_create_property` / `ga4_create_data_stream` / `ga4_plan_bigquery_link` / `ga4_create_bigquery_link` / `ga4_run_report` |
 | Search Console | 6 | `gsc_inspect_url` / `gsc_search_analytics` / `gsc_submit_sitemap` |
 | Google Ads | 6 | `googleads_list_campaigns` / `googleads_get_uac_report` / `googleads_get_campaign_report` |

package/assets/agent-guide.md

@@ -82,6 +82,7 @@ row for the job; batching two rows in one `select:` call is fine.
 | Social posting (Facebook / Instagram / Threads) | `select:facebook_current_config,facebook_save_config,facebook_list_pages,facebook_get_page,facebook_post_photo,facebook_post_multi_photo,instagram_save_config,instagram_get_account,instagram_post_image,instagram_post_carousel,threads_current_config,threads_save_config,threads_refresh_token,threads_get_account,threads_post,threads_post_video,threads_post_carousel` |
 | TikTok Business video publish | `select:tiktok_business_auth_status,tiktok_business_get_account,tiktok_business_get_video_settings,tiktok_business_plan_video_post,tiktok_business_publish_video,tiktok_business_get_publish_status,tiktok_business_list_publish_audits` |
 | Jenkins credentials + jobs | `select:jenkins_status,jenkins_save_config,jenkins_list_credentials,jenkins_create_credential,jenkins_delete_credential,jenkins_upload_keystore,jenkins_upload_playstore_sa,jenkins_list_jobs,jenkins_get_job_config,jenkins_create_job,jenkins_update_job` |
+| Jenkins build run + track | `select:jenkins_status,jenkins_trigger_build,jenkins_get_queue_item,jenkins_get_build_status` |
 | CI (GitHub/GitLab) | `select:ci_save_config,ci_list_workflows,ci_trigger_build,ci_get_build_status,ci_list_recent_builds,ci_cancel_build` |
 | Android signing / keystore | `select:android_signing_setup,android_generate_keystore,jenkins_upload_keystore,jenkins_create_credential,jenkins_upload_playstore_sa` |
 | Service account end-to-end | `select:iam_list_service_accounts,iam_create_service_account,iam_list_keys,iam_create_key,iam_add_iam_policy_binding,setup_playstore_connection,playstore_register_service_account,playstore_verify_service_account,playstore_list_service_accounts,playstore_delete_service_account` |
@@ -159,6 +160,7 @@ Credentials live under `~/.mimi-seed/` (legacy `~/.preseed/` is still read):
 | `play-service-account.json` | default/legacy Play SA (fallback when no per-package match) |
 | `bigquery-service-account.json` | BigQuery SA (exempt from Workspace reauth; OAuth is the fallback) |
 | `jenkins.json`, `ci.json` | Jenkins / GitHub-GitLab CI connection |
+| `jenkins-build-requests/` | `jenkins_trigger_build` dispatch records per `request_id` (hashes + queue id only; do not delete to retry) |
 | `google-ads.json` | Google Ads developer token + customer id |
 | `facebook.json`, `instagram.json`, `threads.json` | Default/legacy Page / account tokens for social post tools |
 | `social-profiles/<profile>.json` | Named Facebook/Instagram/Threads tokens selected by the current project's `.mimi-seed.json` |
@@ -219,7 +221,7 @@ per-domain inventory is [`docs/domain/tool-catalog.md`](domain/tool-catalog.md).
 | **Firebase** | `firebase_create_project` · `firebase_create_android_app` · `firebase_create_ios_app` · `firebase_get_android_config` · `firebase_enable_service` · `firebase_enable_common_services` · `firebase_get_remote_config_overview` · `firebase_list_*_apps` |
 | **AdMob** | `admob_create_app` · `admob_create_ad_unit` · `admob_list_ad_units` · `admob_get_today_earnings` · `admob_get_report` |
 | **CI/CD** | `ci_trigger_build` · `ci_get_build_status` · `ci_list_workflows` (**GitHub Actions / GitLab only**) |
-| **Jenkins** (credentials + jobs) | `jenkins_status` · `jenkins_save_config` · `jenkins_create_credential` · `jenkins_upload_keystore` · `jenkins_upload_playstore_sa` · `jenkins_create_job` · `jenkins_update_job` |
+| **Jenkins** (credentials + jobs + builds) | `jenkins_status` · `jenkins_save_config` · `jenkins_create_credential` · `jenkins_upload_keystore` · `jenkins_upload_playstore_sa` · `jenkins_create_job` · `jenkins_update_job` · `jenkins_trigger_build` · `jenkins_get_queue_item` · `jenkins_get_build_status` |
 | **Google Cloud IAM** | `iam_create_service_account` · `iam_create_key` · `iam_add_iam_policy_binding` |
 | **BigQuery** | `bigquery_run_query` · `bigquery_list_datasets` · `bigquery_get_table_schema` |
 | **GA4** | `ga4_list_properties` · `ga4_create_property` · `ga4_create_data_stream` · `ga4_run_report` · `ga4_plan_bigquery_link` · `ga4_create_bigquery_link` |
@@ -305,17 +307,17 @@ contact sheet; codec validation alone is not a quality pass.
 7. Preview then confirm `video_render`; poll `video_job_status`, then run `video_validate` on the completed MP4.
 
 > **Mimi Seed does not compile app binaries.** It manages metadata, store releases, and
-> CI/Jenkins *credentials and job definitions* — not Xcode/Gradle builds. To produce an
-> `.ipa`/`.aab`, use EAS, Xcode, or a CI/Jenkins job. There is **no `jenkins_trigger_build`
-> tool**; trigger a Jenkins job via its REST API and use the `jenkins_*` tools for
-> credentials and job configs.
+> CI/Jenkins credentials and job definitions, and it can *start* an existing CI or Jenkins job —
+> the job does the Xcode/Gradle build. To produce an `.ipa`/`.aab`, use EAS, Xcode, or a CI/Jenkins job.
+> For Jenkins: `jenkins_trigger_build` (preview, then `confirm: true`) → `jenkins_get_queue_item` for the exact
+> build number → `jenkins_get_build_status`. Never infer the build from `lastBuild` — it may belong to another request.
 
 ---
 
 ## 5. Safety — irreversible actions need explicit confirmation
 
 Every tool marked **D** in the [tool catalog](domain/tool-catalog.md) — submit/promote/release, deletes,
-public posts and review replies, IAM keys and bindings, Jenkins job/credential overwrites, Play service-account
+public posts and review replies, IAM keys and bindings, Jenkins build triggers and job/credential overwrites, Play service-account
 setup, beta invites — is
 **confirm-gated by the server**, and its MCP annotations say `destructiveHint: true`. Call order:
 
@@ -335,12 +337,22 @@ not **D** (private is reversible), but public/unlisted still needs `confirmVisib
 
 Never pass `confirm: true` on the first call, and never retry an uncertain public write automatically.
 
+`jenkins_trigger_build` also takes a caller-chosen `request_id` (one per logical build request). The dry-run does
+**not** reserve it, so preview and confirm with the same `request_id`. Once a confirmed call has used it, every
+later call with that `request_id` returns the recorded result (`replayed: true`) instead of POSTing again — the
+record lives under `~/.mimi-seed/jenkins-build-requests/`, per Jenkins URL and user, on this machine only.
+`state: "pending"` means another call with that `request_id` is still in flight — call again with the same
+`request_id` shortly. `state: "unknown"` means the outcome could not be confirmed — check Jenkins before doing
+anything; do not retry with a new `request_id`. `persisted: false` means only the local record failed: a `queued`
+build is already in the queue, so track its `queue_id` and do not retrigger.
+
 | Action | Why |
 |--------|-----|
 | `playstore_submit_release` / `playstore_promote_release` with `status=completed` | Starts Google review / full rollout. Near-irreversible. |
 | `appstore_submit_for_review`, `appstore_release_version` | Submits to Apple review / publishes immediately. |
 | `appstore_delete_screenshot_set`, `playstore_delete_all_images`, `playstore_replace_images` | Deletes assets. |
 | `playstore_delete_product`, `jenkins_delete_credential`, `firebase_delete_*_app` | Destructive. |
+| `jenkins_trigger_build` | Runs a Jenkins job, which may deploy or publish. |
 | `facebook_post_*`, `instagram_post_*`, `threads_post*`, `*_reply_review`, `youtube_reply_comment` | Public, outward-facing. |
 | `iam_create_key`, `iam_add_iam_policy_binding` | Issues a permanent credential / changes project IAM. |
 
@@ -384,13 +396,16 @@ General rules:
   changes you saved-but-didn't-publish in the Play Console UI. Google's own docs warn
   against editing the same app with both tools at once. Do all listing writes via the
   API, or finish & publish your Console edits first — never interleave them.
-- **`ci_*` is GitHub/GitLab only.** It does not trigger Jenkins builds.
+- **`ci_*` is GitHub/GitLab only.** Jenkins builds use the separate `jenkins_trigger_build` →
+  `jenkins_get_queue_item` → `jenkins_get_build_status` flow.
 - **Identifiers are validated at the schema.** `packageName` / `package_name(s)` must look like an
   Android application id (`com.example.app`) and `bundleId` like an iOS bundle id; anything else
   (`../x`, slashes, empty segments) is rejected with `Input validation error` before the tool runs.
   Google resource ids (project, app, service-account email, AdMob/GA4/billing account) must be a single segment
   (`A-Z a-z 0-9 - _ . : @`) — `../` is refused before any request. BigQuery ids follow BigQuery's own naming
   rules (table names may contain Unicode and spaces), and Play ids may not be exactly `.` or `..`.
+  Jenkins job paths (`folder/job`) are encoded per segment; `.`/`..` segments are refused, and the build tools
+  also refuse empty segments, backslashes, and control characters.
 - **FFmpeg location is configuration, not a tool argument.** The video/TikTok tools no longer take
   `ffmpegPath`; set `MIMI_SEED_FFMPEG_PATH` / `MIMI_SEED_FFPROBE_PATH` or put FFmpeg on `PATH`.
 - **Reward/cash-out apps** are a sensitive Play category — flag policy implications to

package/dist/ai/client.d.ts

@@ -1,12 +1,9 @@
 import Anthropic from '@anthropic-ai/sdk';
 /**
- * mcp-server 가 호출하는 Claude 모델의 SSOT — ai/*, video/* 가 모두 이 값을 쓴다.
- *
- * 예전엔 두 패키지 6개 파일에 리터럴로 흩어져 있어서, 모델 교체가 6곳 수정 + 가드 0 이었다.
- * CLI 쪽 쌍둥이 상수는 `packages/cli/src/ai-model.ts` 이고, 두 값의 일치는
- * `__tests__/ai-model-parity.test.ts` 가 강제한다.
+ * Claude 모델 id — ai/*, video/* 가 모두 이 이름으로 쓴다. 값은 CLI 와 공유하는 packages/core 의
+ * `#core/ai.js` 한 곳에 있다(예전엔 두 패키지에 쌍둥이 상수가 있고 parity 테스트가 비교했다).
  */
-export declare const AI_MODEL = "claude-haiku-4-5-20251001";
+export { AI_MODEL } from '#core/ai.js';
 export declare const LOCALE_NAMES: Record<string, string>;
 export declare function requireApiKey(): Anthropic;
 export declare function parseJsonResponse<T>(text: string): T;

package/dist/ai/client.js

@@ -1,12 +1,9 @@
 import Anthropic from '@anthropic-ai/sdk';
 /**
- * mcp-server 가 호출하는 Claude 모델의 SSOT — ai/*, video/* 가 모두 이 값을 쓴다.
- *
- * 예전엔 두 패키지 6개 파일에 리터럴로 흩어져 있어서, 모델 교체가 6곳 수정 + 가드 0 이었다.
- * CLI 쪽 쌍둥이 상수는 `packages/cli/src/ai-model.ts` 이고, 두 값의 일치는
- * `__tests__/ai-model-parity.test.ts` 가 강제한다.
+ * Claude 모델 id — ai/*, video/* 가 모두 이 이름으로 쓴다. 값은 CLI 와 공유하는 packages/core 의
+ * `#core/ai.js` 한 곳에 있다(예전엔 두 패키지에 쌍둥이 상수가 있고 parity 테스트가 비교했다).
  */
-export const AI_MODEL = 'claude-haiku-4-5-20251001';
+export { AI_MODEL } from '#core/ai.js';
 export const LOCALE_NAMES = {
     'ko': '한국어', 'ko-KR': '한국어',
     'en': '영어', 'en-US': '영어', 'en-GB': '영어',

package/dist/ai/notes.js

@@ -1,4 +1,5 @@
 import { requireApiKey, parseJsonResponse, LOCALE_NAMES, AI_MODEL } from './client.js';
+import { RELEASE_NOTES_MAX_TOKENS, RELEASE_NOTE_TONES } from '#core/ai.js';
 const TONE_DESCRIPTIONS = {
     concise: '간결한 버전 (3줄 이내, 불릿 포인트, 사용자 혜택 중심)',
     detailed: '상세 버전 (주요 변경사항 5~8개, 불릿 포인트, 구체적 기능 설명)',
@@ -14,7 +15,7 @@ function commitsToText(commits) {
 }
 export async function generateReleaseNotesFromCommits(commits, opts = {}) {
     const client = requireApiKey();
-    const { appName = '앱', tones = ['concise', 'detailed', 'marketing'], locales = [], maxTokens = 2000 } = opts;
+    const { appName = '앱', tones = [...RELEASE_NOTE_TONES], locales = [], maxTokens = RELEASE_NOTES_MAX_TOKENS } = opts;
     const commitsText = commitsToText(commits.slice(0, 50));
     const localeList = locales.length > 0
         ? locales.map((l) => `"${l}": "${LOCALE_NAMES[l] ?? l}로 번역된 간결한 버전"`).join(',\n    ')

package/dist/ai/review.js

@@ -1,4 +1,5 @@
 import { requireApiKey, parseJsonResponse, LOCALE_NAMES, AI_MODEL } from './client.js';
+import { detectReviewSentiment, REVIEW_REPLY_MAX_TOKENS } from '#core/ai.js';
 const TONE_GUIDES = {
     friendly: '친근하고 따뜻하게. 이모지 1~2개 사용. 감사 인사로 시작.',
     professional: '정중하고 공식적으로. 문제를 인정하고 해결책을 제시.',
@@ -12,26 +13,14 @@ const SENTIMENT_PROMPTS = {
     bug_report: '버그 리포트입니다. 문제를 확인했음을 알리고, 수정 예정임을 전달하세요.',
     feature_request: '기능 요청입니다. 피드백에 감사하고, 검토하겠다고 약속하세요.',
 };
-function detectSentiment(text) {
-    const lower = text.toLowerCase();
-    if (['버그', '오류', '안됨', 'crash', 'bug', 'error', 'broken'].some((w) => lower.includes(w)))
-        return 'bug_report';
-    if (['추가', '원해', '있으면', 'wish', 'feature', 'add', 'would like'].some((w) => lower.includes(w)))
-        return 'feature_request';
-    if (['별로', '실망', '짜증', 'terrible', 'worst', 'awful'].some((w) => lower.includes(w)))
-        return 'negative';
-    if (['좋아', '최고', '훌륭', 'great', 'excellent', 'love', 'perfect'].some((w) => lower.includes(w)))
-        return 'positive';
-    return 'neutral';
-}
 export async function generateReviewReply(opts) {
     const client = requireApiKey();
     const { reviewText, rating, appName = '앱', tone = 'friendly', language = 'ko', developerName } = opts;
-    const sentiment = detectSentiment(reviewText);
+    const sentiment = detectReviewSentiment(reviewText);
     const langName = LOCALE_NAMES[language] ?? language;
     const response = await client.messages.create({
         model: AI_MODEL,
-        max_tokens: 500,
+        max_tokens: REVIEW_REPLY_MAX_TOKENS,
         system: `앱 개발자를 대신해 스토어 리뷰에 답변하는 전문가입니다. ${langName}로 150자 이내로 답변하세요. ${TONE_GUIDES[tone] ?? TONE_GUIDES.friendly} 개발자 이름: ${developerName ?? '개발팀'}`,
         messages: [{
                 role: 'user',

package/dist/android/keystore-store.js

@@ -8,7 +8,7 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { writeCredentialFile, writeCredentialJson } from '../lib/atomic-write.js';
+import { writeCredentialFile, writeCredentialJson } from '#core/atomic-write.js';
 import { resolveInsideDir } from '../lib/path-containment.js';
 export const KEYSTORE_FILE = 'upload.jks';
 export const SIGNING_SECRETS_FILE = 'signing.json';

package/dist/appstore/apps.js

@@ -121,10 +121,13 @@ export async function createAppInfoLocalization(appId, locale, fields) {
     };
 }
 export async function listCustomerReviews(appId, opts = {}) {
+    // `fields[customerReviews]` 는 JSON:API sparse fieldset 이라 관계에도 적용된다 — `response` 를 빼면
+    // relationships.response 가 응답에서 사라져 include 된 답변을 리뷰에 붙일 수 없고, 모든 리뷰가 미답변
+    // (response: null)으로 보인다. 그러면 "미답변에만 답하기" 흐름이 기존 답변을 교체한다.
     const params = {
         'sort': '-createdDate',
         'limit': String(opts.limit ?? 50),
-        'fields[customerReviews]': 'rating,title,body,reviewerNickname,createdDate,territory',
+        'fields[customerReviews]': 'rating,title,body,reviewerNickname,createdDate,territory,response',
         'include': 'response',
         'fields[customerReviewResponses]': 'responseBody,lastModifiedDate,state',
     };

package/dist/appstore/auth.js

@@ -4,7 +4,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
-import { writeCredentialJson } from '../lib/atomic-write.js';
+import { writeCredentialJson } from '#core/atomic-write.js';
 // Primary location under ~/.mimi-seed. Legacy ~/.preseed read as fallback
 // during the rebrand window so existing App Store Connect sessions don't
 // force a re-setup.

package/dist/appstore/setup-cli.js

@@ -3,7 +3,7 @@ import { getAppStoreCredentials, mergeAppStoreCredentials } from './auth.js';
 import { collectExistingSetupIntent, verifyAndSaveAppStoreCredentials } from './setup.js';
 import readline from 'node:readline';
 import fs from 'node:fs';
-import { resolveLang } from '../lib/lang.js';
+import { resolveLang } from '#core/lang.js';
 // ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
 const ko = {
     title: '  🍎 Mimi Seed — App Store Connect 연결',

package/dist/auth/bigquery-auth.js

@@ -3,7 +3,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { getAuthenticatedClient } from './google-auth.js';
-import { writeCredentialFile } from '../lib/atomic-write.js';
+import { writeCredentialFile } from '#core/atomic-write.js';
 // BigQuery 전용 서비스 계정 키 저장 위치.
 // 서비스 계정 인증은 Google Workspace 의 재인증(reauth) 정책에서 면제되므로,
 // 사용자 OAuth 가 `invalid_rapt` 로 갱신 거부되는 환경에서도 안정적으로 동작한다.

package/dist/auth/bigquery-setup-cli.js

@@ -4,7 +4,7 @@ import fs from 'node:fs';
 import { saveBigQueryServiceAccountJson, getBigQueryServiceAccountKey, } from './bigquery-auth.js';
 import * as bigquery from '../bigquery/tools.js';
 import { newJWT } from '../lib/google-auth-lite.js';
-import { resolveLang } from '../lib/lang.js';
+import { resolveLang } from '#core/lang.js';
 // ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
 const ko = {
     title: '  🤖 Mimi Seed — BigQuery 서비스 계정 연결',

package/dist/auth/cli.js

@@ -5,7 +5,7 @@ import { AuthError, classifyError } from './errors.js';
 import { getMcpOAuthClient } from './constants.js';
 import { AUTH_DOMAINS, DOMAIN_IDS, parseDomainList, summarizeGrantedDomains, } from './scopes.js';
 import { openPrivateBrowser } from './browser.js';
-import { resolveLang } from '../lib/lang.js';
+import { resolveLang } from '#core/lang.js';
 // ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
 // 여기 있는 건 전부 **터미널에 찍히는 사람용 문자열**이다. errors.ts 가 만드는
 // code/message/hint 는 라이브러리 텍스트라 그대로 출력한다.

package/dist/auth/google-auth.js

@@ -9,7 +9,7 @@ import { getMcpOAuthClient } from './constants.js';
 import { AuthError, classifyError } from './errors.js';
 // 스코프 목록의 SSOT 는 scopes.ts (도메인 → 스코프 매핑). 여기서는 로그인 요청 조립만 한다.
 import { scopesForDomains, IDENTITY_SCOPES } from './scopes.js';
-import { writeCredentialJson } from '../lib/atomic-write.js';
+import { writeCredentialJson } from '#core/atomic-write.js';
 import { fetchWithTimeout } from '../lib/http.js';
 // Primary config dir. Legacy `~/.preseed` is read as a fallback during the
 // rebrand so existing auth sessions don't force a re-login; new writes go to

package/dist/auth/playstore-auth.js

@@ -3,7 +3,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { PLAY_DEVELOPER_REPORTING_SCOPE } from './scopes.js';
-import { writeCredentialFile } from '../lib/atomic-write.js';
+import { writeCredentialFile } from '#core/atomic-write.js';
 import { assertAndroidPackageName, isValidAndroidPackageName } from '../lib/package-name.js';
 const CONFIG_DIR = path.join(os.homedir(), '.mimi-seed');
 const SA_DIR = path.join(CONFIG_DIR, 'play-service-accounts');

package/dist/auth/playstore-setup-cli.js

@@ -2,7 +2,7 @@
 import { saveServiceAccountJson, getServiceAccountJson } from './playstore-auth.js';
 import readline from 'node:readline';
 import fs from 'node:fs';
-import { resolveLang } from '../lib/lang.js';
+import { resolveLang } from '#core/lang.js';
 // ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
 const ko = {
     title: '  🤖 Mimi Seed — Google Play 서비스 계정 연결',

package/dist/checks/billing-network.d.ts

@@ -1,2 +1,2 @@
-import { type BillingTransitiveResolver } from './billing.js';
+import { type BillingTransitiveResolver } from '#core/checks/billing.js';
 export declare const resolveOpenIapBilling: BillingTransitiveResolver;

package/dist/checks/billing-network.js

@@ -1,5 +1,5 @@
 import { fetchWithTimeout } from '../lib/http.js';
-import { billingVersionFromPom } from './billing.js';
+import { billingVersionFromPom } from '#core/checks/billing.js';
 export const resolveOpenIapBilling = async (openIapVersion) => {
     const pomUrl = `https://repo.maven.apache.org/maven2/io/github/hyochan/openiap/openiap-google/${openIapVersion}/openiap-google-${openIapVersion}.pom`;
     const response = await fetchWithTimeout(pomUrl, {}, { timeoutMs: 15_000, maxAttempts: 2 });

package/dist/checks/release-doctor-cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { resolveLang } from '../lib/lang.js';
-import { scanReleaseDoctor } from './release-doctor.js';
+import { resolveLang } from '#core/lang.js';
+import { scanReleaseDoctor } from '#core/checks/release-doctor.js';
 import { parseReleaseDoctorArgs, RELEASE_DOCTOR_USAGE } from './release-doctor-cli-args.js';
-import { renderReleaseDoctor } from './release-doctor-render.js';
+import { renderReleaseDoctor } from '#core/checks/release-doctor-render.js';
 async function main() {
     const args = parseReleaseDoctorArgs(process.argv.slice(2));
     if (args.help) {

package/dist/ci/config.d.ts

@@ -1,11 +1,5 @@
-export type CiProvider = 'github' | 'gitlab';
-export interface CiConfig {
-    provider: CiProvider;
-    token: string;
-    owner: string;
-    repo: string;
-    host?: string;
-}
+import type { CiConfig } from '#core/ci.js';
+export type { CiConfig, CiProvider } from '#core/ci.js';
 export declare function loadCiConfig(): CiConfig | null;
 export declare function saveCiConfig(config: CiConfig): void;
 export declare function requireCiConfig(): CiConfig;

package/dist/ci/config.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
-import { writeCredentialJson } from '../lib/atomic-write.js';
+import { writeCredentialJson } from '#core/atomic-write.js';
 const CONFIG_DIR = path.join(os.homedir(), '.mimi-seed');
 const CI_CONFIG_PATH = path.join(CONFIG_DIR, 'ci.json');
 export function loadCiConfig() {

package/dist/ci/github.js

@@ -1,23 +1,11 @@
 import { fetchWithTimeout } from '../lib/http.js';
 import { encodePathSegment } from '../lib/url-path.js';
-function base(cfg) {
-    // GitHub Enterprise: host = https://github.example.com → API base = https://github.example.com/api/v3
-    if (cfg.host)
-        return `${cfg.host.replace(/\/$/, '')}/api/v3`;
-    return 'https://api.github.com';
-}
-function headers(token) {
-    return {
-        Authorization: `Bearer ${token}`,
-        Accept: 'application/vnd.github+json',
-        'X-GitHub-Api-Version': '2022-11-28',
-        'Content-Type': 'application/json',
-    };
-}
+import { githubApiBase, githubHeaders } from '#core/ci.js';
 async function ghFetch(cfg, endpoint, options) {
-    const res = await fetchWithTimeout(`${base(cfg)}${endpoint}`, {
+    // base URL · 헤더 규칙은 CLI 의 배포 경로와 공유한다(#core/ci.js) — 검증과 실제 호출이 같은 URL 을 만든다.
+    const res = await fetchWithTimeout(`${githubApiBase(cfg)}${endpoint}`, {
         ...options,
-        headers: { ...headers(cfg.token), ...(options?.headers ?? {}) },
+        headers: { ...githubHeaders(cfg.token), ...(options?.headers ?? {}) },
     });
     if (res.status === 204)
         return null;

package/dist/ci/gitlab.js

@@ -1,12 +1,6 @@
 import { fetchWithTimeout } from '../lib/http.js';
 import { encodePathSegment } from '../lib/url-path.js';
-function base(cfg) {
-    return `${cfg.host ?? 'https://gitlab.com'}/api/v4`;
-}
-// GitLab accepts both numeric project ID and "namespace%2Frepo" path
-function projectId(cfg) {
-    return encodeURIComponent(`${cfg.owner}/${cfg.repo}`);
-}
+import { gitlabApiBase, gitlabProjectId } from '#core/ci.js';
 function headers(token) {
     return {
         'PRIVATE-TOKEN': token,
@@ -14,7 +8,8 @@ function headers(token) {
     };
 }
 async function glFetch(cfg, endpoint, options) {
-    const res = await fetchWithTimeout(`${base(cfg)}${endpoint}`, {
+    // base URL · 프로젝트 id 규칙은 CLI 의 배포 경로와 공유한다(#core/ci.js).
+    const res = await fetchWithTimeout(`${gitlabApiBase(cfg)}${endpoint}`, {
         ...options,
         headers: { ...headers(cfg.token), ...(options?.headers ?? {}) },
     });
@@ -27,8 +22,8 @@ async function glFetch(cfg, endpoint, options) {
 }
 export async function listWorkflows(cfg) {
     const [schedules, triggers] = await Promise.all([
-        glFetch(cfg, `/projects/${projectId(cfg)}/pipeline_schedules`),
-        glFetch(cfg, `/projects/${projectId(cfg)}/triggers`),
+        glFetch(cfg, `/projects/${gitlabProjectId(cfg)}/pipeline_schedules`),
+        glFetch(cfg, `/projects/${gitlabProjectId(cfg)}/triggers`),
     ]);
     return {
         schedules: schedules.map((s) => ({
@@ -50,25 +45,25 @@ export async function triggerBuild(cfg, ref = 'main', variables = {}) {
     const body = { ref };
     if (vars.length > 0)
         body.variables = vars;
-    const data = await glFetch(cfg, `/projects/${projectId(cfg)}/pipeline`, {
+    const data = await glFetch(cfg, `/projects/${gitlabProjectId(cfg)}/pipeline`, {
         method: 'POST',
         body: JSON.stringify(body),
     });
     return normalize(data);
 }
 export async function getBuildStatus(cfg, pipelineId) {
-    const data = await glFetch(cfg, `/projects/${projectId(cfg)}/pipelines/${encodePathSegment(pipelineId)}`);
+    const data = await glFetch(cfg, `/projects/${gitlabProjectId(cfg)}/pipelines/${encodePathSegment(pipelineId)}`);
     return normalize(data);
 }
 export async function listRecentBuilds(cfg, ref, limit = 10) {
-    let endpoint = `/projects/${projectId(cfg)}/pipelines?per_page=${limit}&order_by=id&sort=desc`;
+    let endpoint = `/projects/${gitlabProjectId(cfg)}/pipelines?per_page=${limit}&order_by=id&sort=desc`;
     if (ref)
         endpoint += `&ref=${encodeURIComponent(ref)}`;
     const data = await glFetch(cfg, endpoint);
     return data.map(normalize);
 }
 export async function cancelBuild(cfg, pipelineId) {
-    await glFetch(cfg, `/projects/${projectId(cfg)}/pipelines/${encodePathSegment(pipelineId)}/cancel`, {
+    await glFetch(cfg, `/projects/${gitlabProjectId(cfg)}/pipelines/${encodePathSegment(pipelineId)}/cancel`, {
         method: 'POST',
     });
 }

package/dist/core/ai.d.ts

@@ -0,0 +1,17 @@
+/** Claude 모델 id 의 SSOT. 모델 교체는 이 한 줄이다 (다른 곳의 리터럴은 ai-model.test.ts 가 막는다). */
+export declare const AI_MODEL = "claude-haiku-4-5-20251001";
+/** 리뷰 답변 톤 — CLI `--tone` 값이자 MCP `generate_review_reply` 의 tone 인자. 번역하지 않는다. */
+export declare const REVIEW_TONES: readonly ["friendly", "professional", "empathetic", "brief"];
+export type ReviewTone = (typeof REVIEW_TONES)[number];
+/** detectReviewSentiment 의 반환값 = 두 생성기의 감정별 지시문 테이블 키. */
+export declare const REVIEW_SENTIMENTS: readonly ["positive", "negative", "neutral", "bug_report", "feature_request"];
+export type ReviewSentiment = (typeof REVIEW_SENTIMENTS)[number];
+/** 리뷰 본문 → 감정. 어느 키워드에도 안 걸리면 neutral. */
+export declare function detectReviewSentiment(text: string): ReviewSentiment;
+/** 리뷰 답변의 토큰 상한. */
+export declare const REVIEW_REPLY_MAX_TOKENS = 500;
+/** 릴리즈 노트의 토큰 상한 — 낮은 쪽만 다국어(localized) JSON 이 잘린다. */
+export declare const RELEASE_NOTES_MAX_TOKENS = 2000;
+/** 릴리즈 노트 톤 이름 — 응답 JSON 의 파싱 계약이라 번역하지 않는다 (+ 다국어 버전 키 `localized`). */
+export declare const RELEASE_NOTE_TONES: readonly ["concise", "detailed", "marketing"];
+export type ReleaseNoteTone = (typeof RELEASE_NOTE_TONES)[number];

package/dist/core/ai.js

@@ -0,0 +1,40 @@
+// AI 생성기(리뷰 답변 · 릴리즈 노트)의 **언어와 무관한 계약** — CLI 와 mcp-server 가 공유한다.
+//
+// 생성기 자체는 두 벌이다. 그건 사고가 아니라 선택이다: CLI 판은 프롬프트 지시문까지
+// `catalog(ko, en)` 을 거쳐 영어 사용자에게 영어 톤 가이드를 주고, MCP 판은 한국어 고정이며,
+// 두 릴리즈 노트 생성기는 응답 스키마부터 다르다(MCP `tones[]` 배열 vs CLI 평면 키).
+//
+// 갈라지면 안 되는 것만 여기 둔다. 예전엔 이것들이 두 패키지에 리터럴로 흩어져 있었고
+// ai-model-parity / ai-parity 테스트가 소스 텍스트를 정규식으로 비교했다 — 실제로 노트의
+// max_tokens 는 1500 vs 2000 으로 이미 갈라져 있었다. 이제 컴파일러가 강제한다.
+/** Claude 모델 id 의 SSOT. 모델 교체는 이 한 줄이다 (다른 곳의 리터럴은 ai-model.test.ts 가 막는다). */
+export const AI_MODEL = 'claude-haiku-4-5-20251001';
+/** 리뷰 답변 톤 — CLI `--tone` 값이자 MCP `generate_review_reply` 의 tone 인자. 번역하지 않는다. */
+export const REVIEW_TONES = ['friendly', 'professional', 'empathetic', 'brief'];
+/** detectReviewSentiment 의 반환값 = 두 생성기의 감정별 지시문 테이블 키. */
+export const REVIEW_SENTIMENTS = ['positive', 'negative', 'neutral', 'bug_report', 'feature_request'];
+/**
+ * 감정 분류 키워드. **순서가 의미다** — 앞의 규칙이 이긴다("버그인데 최고" 는 bug_report).
+ * 한국어가 섞여 있는 건 번역 대상이 아니라 매칭 대상이기 때문이다.
+ */
+const SENTIMENT_KEYWORDS = [
+    ['bug_report', ['버그', '오류', '안됨', 'crash', 'bug', 'error', 'broken']],
+    ['feature_request', ['추가', '원해', '있으면', 'wish', 'feature', 'add', 'would like']],
+    ['negative', ['별로', '실망', '짜증', 'terrible', 'worst', 'awful']],
+    ['positive', ['좋아', '최고', '훌륭', 'great', 'excellent', 'love', 'perfect']],
+];
+/** 리뷰 본문 → 감정. 어느 키워드에도 안 걸리면 neutral. */
+export function detectReviewSentiment(text) {
+    const lower = text.toLowerCase();
+    for (const [sentiment, keywords] of SENTIMENT_KEYWORDS) {
+        if (keywords.some((w) => lower.includes(w)))
+            return sentiment;
+    }
+    return 'neutral';
+}
+/** 리뷰 답변의 토큰 상한. */
+export const REVIEW_REPLY_MAX_TOKENS = 500;
+/** 릴리즈 노트의 토큰 상한 — 낮은 쪽만 다국어(localized) JSON 이 잘린다. */
+export const RELEASE_NOTES_MAX_TOKENS = 2000;
+/** 릴리즈 노트 톤 이름 — 응답 JSON 의 파싱 계약이라 번역하지 않는다 (+ 다국어 버전 키 `localized`). */
+export const RELEASE_NOTE_TONES = ['concise', 'detailed', 'marketing'];

package/dist/{lib → core}/atomic-write.d.ts

@@ -22,10 +22,7 @@ export interface AtomicWriteOptions {
  * 왜: Windows 는 다른 프로세스가 대상 파일을 열고 있으면(백신·검색 인덱서·OneDrive, 또는
  * tokens.json 을 읽는 중인 다른 mimi-seed 프로세스) rename 을 EPERM/EBUSY/EACCES 로 거절한다.
  * 그 핸들은 보통 수십~수백 ms 안에 닫히므로, 짧게 물러났다 다시 시도하면 대부분 통과한다.
- *
- * ⚠️ CLI 쪽 원자적 쓰기 사본(packages/cli)과 **이름·값이 완전히 같아야 한다**
- * (RENAME_RETRY_CODES / RENAME_RETRY_DELAYS_MS / renameWithRetry). 한쪽을 바꾸면 다른 쪽도 맞출 것 —
- * 두 패키지는 서로 import 하지 않으므로 이 상수가 유일한 동기화 지점이다.
+ * 동기 writer 안에서 기다리므로 총합(1초)이 곧 최악의 블로킹 시간이다 — 늘리지 말 것.
  */
 export declare const RENAME_RETRY_DELAYS_MS: readonly [10, 20, 40, 80, 160, 320, 370];
 /** 재시도할 오류 코드. ENOENT 등은 잠금이 아니라 진짜 실패이므로 즉시 던진다. */

package/dist/{lib → core}/atomic-write.js

@@ -8,6 +8,11 @@
 //
 // temp 파일에 다 쓴 뒤 rename(2) 하면 교체가 원자적이다 — 읽는 쪽은 항상 옛 내용 아니면
 // 새 내용을 보고, 그 중간은 존재하지 않는다.
+//
+// CLI 와 mcp-server 가 **이 한 구현**을 쓴다. 예전엔 패키지마다 사본이 있었고, Windows 재시도
+// 스케줄이 갈라지지 않게 rename-retry-parity 테스트가 두 사본의 리터럴을 비교했다 — 같은
+// tokens.json 을 두고 한쪽만 잠금 경합에서 살아남는 상황을 막으려고. 이제 갈라질 사본이 없다.
+// 어느 모듈이 이 writer 를 거쳐야 하는지는 각 패키지의 atomic-write.test.ts 가 강제한다.
 import { chmodSync, mkdirSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
 import path from 'node:path';
@@ -21,10 +26,7 @@ export const CREDENTIAL_DIR_MODE = 0o700;
  * 왜: Windows 는 다른 프로세스가 대상 파일을 열고 있으면(백신·검색 인덱서·OneDrive, 또는
  * tokens.json 을 읽는 중인 다른 mimi-seed 프로세스) rename 을 EPERM/EBUSY/EACCES 로 거절한다.
  * 그 핸들은 보통 수십~수백 ms 안에 닫히므로, 짧게 물러났다 다시 시도하면 대부분 통과한다.
- *
- * ⚠️ CLI 쪽 원자적 쓰기 사본(packages/cli)과 **이름·값이 완전히 같아야 한다**
- * (RENAME_RETRY_CODES / RENAME_RETRY_DELAYS_MS / renameWithRetry). 한쪽을 바꾸면 다른 쪽도 맞출 것 —
- * 두 패키지는 서로 import 하지 않으므로 이 상수가 유일한 동기화 지점이다.
+ * 동기 writer 안에서 기다리므로 총합(1초)이 곧 최악의 블로킹 시간이다 — 늘리지 말 것.
  */
 export const RENAME_RETRY_DELAYS_MS = [10, 20, 40, 80, 160, 320, 370];
 /** 재시도할 오류 코드. ENOENT 등은 잠금이 아니라 진짜 실패이므로 즉시 던진다. */

package/dist/core/ci.d.ts

@@ -0,0 +1,16 @@
+export type CiProvider = 'github' | 'gitlab';
+export interface CiConfig {
+    provider: CiProvider;
+    token: string;
+    owner: string;
+    repo: string;
+    /** GitHub Enterprise / GitLab self-hosted 의 origin (예: https://git.example.com). 없으면 공용 호스트. */
+    host?: string;
+}
+/** GitHub REST base. Enterprise 는 `<host>/api/v3`. */
+export declare function githubApiBase(cfg: Pick<CiConfig, 'host'>): string;
+export declare function githubHeaders(token: string): Record<string, string>;
+/** GitLab REST base (v4). self-hosted 는 `<host>/api/v4`. */
+export declare function gitlabApiBase(cfg: Pick<CiConfig, 'host'>): string;
+/** GitLab 은 숫자 id 대신 URL 인코딩한 `namespace/repo` 경로를 프로젝트 id 로 받는다. */
+export declare function gitlabProjectId(cfg: Pick<CiConfig, 'owner' | 'repo'>): string;

package/dist/core/ci.js

@@ -0,0 +1,29 @@
+// CI 프로바이더(GitHub Actions / GitLab CI) 연결의 **공유 계약** — `~/.mimi-seed/ci.json` 의 모양과
+// REST base URL 규칙.
+//
+// ci.json 은 두 패키지가 쓰는 문서화된 예외다(CLI `mimi-seed deploy` 셋업, MCP `ci_save_config`).
+// 그래서 모양이 한 곳에 있어야 하고, base URL 을 조립하는 규칙도 같아야 한다 — 다르면 "CLI 로 검증은
+// 통과했는데 MCP 도구는 404" 가 된다. 클라이언트 자체(요청·폴링·에러 문구·경로 인코딩)는 두 패키지의
+// 쓰임이 달라 각자 둔다: cli/src/ci-providers.ts, mcp-server/src/ci/{github,gitlab}.ts.
+/** GitHub REST base. Enterprise 는 `<host>/api/v3`. */
+export function githubApiBase(cfg) {
+    if (cfg.host)
+        return `${cfg.host.replace(/\/$/, '')}/api/v3`;
+    return 'https://api.github.com';
+}
+export function githubHeaders(token) {
+    return {
+        Authorization: `Bearer ${token}`,
+        Accept: 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2022-11-28',
+        'Content-Type': 'application/json',
+    };
+}
+/** GitLab REST base (v4). self-hosted 는 `<host>/api/v4`. */
+export function gitlabApiBase(cfg) {
+    return `${cfg.host ?? 'https://gitlab.com'}/api/v4`;
+}
+/** GitLab 은 숫자 id 대신 URL 인코딩한 `namespace/repo` 경로를 프로젝트 id 로 받는다. */
+export function gitlabProjectId(cfg) {
+    return encodeURIComponent(`${cfg.owner}/${cfg.repo}`);
+}

package/dist/core/http-errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 에러 메시지에 쓸 엔드포인트 라벨 — host + path 만.
+ *
+ * 쿼리스트링은 **의도적으로 버린다**: Meta Graph API 의 `?access_token=…`, GitLab 의
+ * `?private_token=…` 처럼 토큰이 실릴 수 있고, 에러는 에이전트 전사록·터미널·CI 로그에 남는다.
+ * URL 로 해석되지 않으면 호출부가 준 `fallback`(각 패키지 언어의 "외부 서버")을 쓴다.
+ */
+export declare function endpointLabel(input: string | URL, fallback: string): string;
+/** AbortSignal.timeout 이 만든 중단인가. undici 가 cause 로 한 겹 싸는 경우까지 본다. */
+export declare function isTimeoutAbort(error: unknown): boolean;