triflux 10.45.0 → 10.47.0

package/skills/tfx-profile/SKILL.md

@@ -45,7 +45,7 @@ options:
 ```
 | 프로파일 | 모델 | Effort |
 |----------|------|--------|
-| gpt56_terra_high | 프로필 설정의 현재 모델 | high |
+| gpt6_sol_high | 프로필 설정의 현재 모델 | high |
 | ...  | ...           | ...  |
 ```
 
@@ -75,9 +75,10 @@ options:
 2. AskUserQuestion으로 프로필/alias 선택:
    ```
    options:
-     - label: "gpt56_terra_high" → 기본 고품질 (Recommended)
-     - label: "gpt56_terra_med"  → 균형형
-     - label: "gpt56_luna_low"   → 빠른 경량
+     - label: "gpt6_sol_high"    → 구현과 리뷰 기본값 (Recommended)
+     - label: "gpt6_sol_med"     → 정리와 리팩터 균형형
+     - label: "gpt6_luna_high"   → 명확한 반복 작업
+     - label: "gpt6_luna_low"    → 지연 우선 경량
      - label: "gpt6_astra_xhigh" → 고강도 추론
      - label: "gpt6_astra_max"   → 최난도 단일 작업
      - label: "gpt6_astra_ultra" → 최상위 자동 위임 (비중첩 전용)
@@ -187,12 +188,13 @@ options:
 
 | 프로필 | 용도 |
 |------|------|
-| gpt56_terra_high | 기본 고품질 |
+| gpt6_sol_high | 구현과 리뷰 기본값 |
 | gpt6_astra_xhigh | 고강도 추론 |
 | gpt6_astra_max | 최난도 단일 작업 |
 | gpt6_astra_ultra | 최상위 자동 위임 (비중첩 전용) |
-| gpt56_terra_med | 균형형 |
-| gpt56_luna_low | 빠른 경량 |
+| gpt6_sol_med | 정리와 리팩터 균형형 |
+| gpt6_luna_high | 명확한 반복 작업 |
+| gpt6_luna_low | 지연 우선 경량 |
 | custom | 사용자가 관리하는 프로필 |
 
 ### Codex Effort 레벨

package/skills/tfx-setup/SKILL.md

@@ -112,7 +112,7 @@ Bash("triflux setup")
 #### 단계 3: Codex 프로파일
 
 `~/.codex/config.toml`을 Read 도구로 읽어 필수 프로파일 존재 여부 확인.
-필수: `gpt6_astra_ultra`, `gpt6_astra_max`, `gpt6_astra_xhigh`, `gpt56_terra_high`, `gpt56_terra_med`, `gpt56_luna_low`.
+필수: `gpt6_astra_ultra`, `gpt6_astra_max`, `gpt6_astra_xhigh`, `gpt6_sol_high`, `gpt6_sol_med`, `gpt6_luna_high`, `gpt6_luna_low`.
 
 - 모두 존재 → ✅ 표시
 - 누락 있으면 → AskUserQuestion:

package/skills/tfx-ship/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: tfx-ship
 description: >
-  triflux 전용 릴리즈 자동화. **GitHub Actions(release.yml dispatch / npm-publish.yml) 기반 CI 릴리즈가 기본 경로 —
+  triflux 전용 릴리즈 자동화. **GitHub Actions(버전 증가 PR 머지 / release.yml dispatch / npm-publish.yml) 기반 CI 릴리즈가 기본 경로 -
   npm publish 는 OIDC Trusted Publishing 으로 CI 가 수행하므로 로컬 npm login 불필요.** scripts/release/* 래퍼 +
   AskUserQuestion 기반 버전 선택 + CHANGELOG 편집 게이트 + Co-Authored-By/AI trailer 금지 강제. 'ship', '배포', '릴리즈',
   'release', 'tfx-ship', 'publish' 같은 요청에 반드시 사용.
 argument-hint: "[patch|minor|major|<version>] [--skip-tests] [--no-publish] [--dry-run]"
 ---
 
-# tfx-ship — triflux 릴리즈 자동화
+# tfx-ship - triflux 릴리즈 자동화
 
 > **ARGUMENTS 처리**: ARGUMENTS 가 있으면 첫 토큰을 version bump 타입 또는 명시 버전으로 해석.
 > 플래그는 `--skip-tests`, `--no-publish`, `--dry-run` 지원.
@@ -28,11 +28,11 @@ triflux 는 아래 3채널로 동시 배포. 각 채널의 버전은 반드시
 | # | 채널 | 명령 | 우선순위 |
 |---|------|------|---------|
 | 1 | **GitHub Releases** | `gh release create vX.Y.Z --notes-file <notes>` | 공지 + changelog 공식 소스 |
-| 2 | **npm registry** | **CI `npm-publish.yml`** (`v*` 태그 push 자동 / OIDC Trusted Publishing, `NPM_TOKEN` secret) | primary distribution |
+| 2 | **npm registry** | **CI `npm-publish.yml`** (`v*` 태그 push 자동 / OIDC Trusted Publishing) | primary distribution |
 | 3 | **Claude Code marketplace** | `.claude-plugin/marketplace.json` (`source: npm` 참조) | `claude plugin add triflux` |
 | 4 | **pypi** (future, 비활성) | 현재 `pyproject.toml` 없음 | 활성화 시 Step 10.5 신설 |
 
-- **npm publish 는 로컬에서 하지 않는다** — `release.yml` dispatch 또는 `v*` 태그 push 시 `npm-publish.yml` 이 OIDC 로 발행한다. 로컬 `publish.mjs --execute` 는 CI 불가 시 폴백 전용.
+- **npm publish 는 로컬에서 하지 않는다** - 버전을 올린 PR 머지 후 ci 성공, `release.yml` dispatch 또는 `v*` 태그 push 시 `npm-publish.yml` 이 OIDC 로 발행한다. 로컬 `publish.mjs --execute` 는 CI 불가 시 폴백 전용.
 - marketplace 는 자체 publish 명령이 없음. marketplace.json 의 version 만 갱신하면 git push 로 반영됨 (GitHub 호스팅).
 - `release:check-sync` 가 package.json + marketplace.json + package-lock.json 3곳 version 일치를 강제한다.
 - pypi 는 triflux 가 Python 모듈을 가지게 되면 활성화. 현 단계는 플레이스홀더.
@@ -42,19 +42,26 @@ triflux 는 아래 3채널로 동시 배포. 각 채널의 버전은 반드시
 ## 전제 조건
 
 - `~/.claude/scripts/tfx-route.sh` 불필요 (CLI 워커 호출 없음)
-- `gh` CLI 인증됨 (`gh auth status`) — `release.yml` dispatch / GitHub release 에 필요. 깨졌으면 웹 UI 대체
-- **npm 인증 불필요** — npm publish 는 CI(`npm-publish.yml`)가 OIDC/`NPM_TOKEN` 으로 수행 (로컬 `npm login` 필요 없음)
-- 릴리즈할 코드가 `origin/main` 에 있을 것 (CI 는 `--ref main` 으로 origin 을 checkout)
+- `gh` CLI 인증됨 (`gh auth status`) - `release.yml` dispatch / GitHub release 에 필요. 깨졌으면 웹 UI 대체
+- **npm 인증 불필요** - npm publish 는 CI(`npm-publish.yml`)가 OIDC 로 수행 (로컬 `npm login` 필요 없음)
+- 릴리즈할 커밋이 `origin/main` 에 포함되어 있을 것. 자동 경로는 ci 의 head_sha, 수동 경로는 dispatch 시점의 github.sha 를 checkout 한다.
 
-## 기본 경로 — CI 릴리즈 (권장)
+## 기본 경로 - CI 릴리즈 (권장)
+
+PR 에서 `npm run release:bump -- --version X --write` 로 버전을 올려 main 에 머지하면,
+같은 커밋의 ci 통과 뒤 `release.yml` 이 자동으로 실행된다. 버전을 안 올린 머지는 릴리즈하지 않는다.
+자동 경로는 해당 커밋과 첫 번째 부모의 package.json 버전을 비교한다. 버전이 같거나 이미 태그가 있으면 건너뛰고, prerelease 는 수동 dispatch 로 진행한다.
+main 이 앞서 있어도 해당 커밋이 origin/main 의 조상이면 릴리즈한다. 강제 푸시로 main 에서 사라진 커밋은 건너뛰고, 최신 안정 태그 이하로 버전이 역행하면 실패한다.
+`resolve` 잡은 동시성 제한 없이 판정하고, 실제 `release` 잡만 `release` concurrency 그룹에서 직렬 실행한다. 자동 경로만 `publish.mjs --allow-ancestor` 를 사용하며 수동 경로는 기존 HEAD 동등성 검사를 유지한다.
+버전을 올린 커밋 두 개가 거의 동시에 들어오면 앞의 대기 릴리즈가 취소될 수 있다. 해당 커밋의 ci 를 Re-run 하거나 `release.yml` 을 수동 dispatch 해 복구한다.
 
 > **npm publish 는 로컬에서 하지 않는다.** GitHub Actions 가 OIDC(Trusted Publishing)로 발행한다.
 > 워크플로우: `.github/workflows/{release,npm-publish,ci}.yml`
 
-- **`release.yml`** (`workflow_dispatch`, inputs: `version`, `channel`): 한 번의 dispatch 로 prepare(테스트/버전 bump) → 태그 + GitHub release(`publish.mjs --skip-npm`) → `npm-publish.yml` dispatch → npm publish 완료 대기 → `verify.mjs` 까지 전부 CI(ubuntu, node 24)에서 수행.
-- **`npm-publish.yml`** (`on: push tags ['v*']` + dispatch): `v*` 태그가 push 되면 자동 npm publish (`--provenance --access public`, `NPM_TOKEN` secret). 루트/core/triflux 3패키지 각각, 이미 게시된 버전은 skip.
+- **`release.yml`** (`workflow_run` + `workflow_dispatch`, inputs: `version`, `channel`): prepare → 태그 + GitHub release(`publish.mjs --skip-npm`) → 태그 ref 와 channel 에 따른 npm_tag(stable=latest, canary=canary)로 `npm-publish.yml` dispatch → 반환 URL의 run ID로 npm publish 완료 대기 → `verify.mjs` 까지 CI(ubuntu, node 24)에서 수행한다. 자동 경로는 같은 커밋의 ci 가 전체 테스트를 통과했으므로 prepare 에서 테스트만 생략한다. 수동 dispatch 는 기존대로 테스트한다. npm 레지스트리 반영은 20초 간격으로 최대 900초 기다리고, 기대 버전이 아직 보이지 않으면 pending 경고를 남기고 통과한다. 2026-09-23 게시에서 반영까지 `@triflux/core` 3분, `triflux` 1시간 25분, `@triflux/remote` 11시간이 걸렸다. 구버전 gh 가 실행 URL을 반환하지 않으면 dispatch 직전 저장한 기존 실행 ID를 제외해 새 실행을 고른다.
+- **`npm-publish.yml`** (`on: push tags ['v*']` + dispatch): `v*` 태그가 push 되면 자동 npm publish (`--provenance --access public --tag "$NPM_TAG"`, OIDC 전용). dispatch 의 선택 입력 `npm_tag` 가 있으면 사용하고, 없으면 버전에 `-` 가 있을 때 canary, 그 밖에는 latest 로 게시한다. latest 와 canary 외의 값은 거부한다. `@triflux/core`, `@triflux/remote`, `triflux` 3패키지 각각, 이미 게시된 버전은 skip. 세 패키지 모두 Trusted Publisher 등록이 필요하며 `npm trust list <패키지>` 로 확인한다.
 
-### 권장 실행 — release.yml 디스패치
+### 수동 실행 - release.yml 디스패치
 
 ```bash
 gh workflow run release.yml --ref main -f version=<X.Y.Z> -f channel=stable
@@ -66,7 +73,7 @@ gh run watch "$(gh run list --workflow release.yml -L1 --json databaseId -q '.[0
 - gh 인증이 없는 환경(예: SSH→m2, hosts.yml PAT 만료)이면 **gh 가 정상인 머신(m5)에서** dispatch 하거나 **GitHub 웹 UI**(Actions → release → Run workflow)로 대체.
 - CHANGELOG 가 필요하면 dispatch 전에 main 에 별도 커밋으로 반영(아래 로컬 플로우 Step 4 양식 참조).
 
-### 경량 경로 — 태그만 push
+### 경량 경로 - 태그만 push
 
 이미 검증된 hotfix 등 prepare/verify 없이 npm publish 만 트리거하려면:
 
@@ -79,12 +86,12 @@ git tag v<X.Y.Z> && git push origin v<X.Y.Z>   # → npm-publish.yml 자동 발
 
 ---
 
-## 로컬 수동 플로우 (폴백 — CI 불가 시에만)
+## 로컬 수동 플로우 (폴백 - CI 불가 시에만)
 
 > CI 가 정석이다. 아래는 Actions 가 막혔거나 로컬 디버깅 시의 수동 절차다.
 > **Step 10 의 로컬 `npm publish` 는 CI 와 중복이므로 평상시 실행 금지.**
 
-### Step 0 — 환경 확인
+### Step 0 - 환경 확인
 
 ```bash
 cd "$REPO_ROOT"
@@ -100,7 +107,7 @@ node --version                      # Node 18+ 확인
 - uncommitted 있음 → **AskUserQuestion**: "먼저 커밋할까? / ship 에 포함 / 취소"
 - behind origin → `git pull origin main` 먼저 실행
 
-### Step 1 — 버전 선택
+### Step 1 - 버전 선택
 
 ARGUMENTS 에 version 있으면 그 값 사용. 없으면 AskUserQuestion:
 
@@ -108,15 +115,15 @@ ARGUMENTS 에 version 있으면 그 값 사용. 없으면 AskUserQuestion:
 현재: v{CURRENT}
 어떤 버전으로 올릴까요?
 
-A) patch (v{CURRENT +0.0.1}) — bug fix / small refactor
-B) minor (v{CURRENT +0.1.0}) — 새 기능, backward compatible
-C) major (v{CURRENT +1.0.0}) — breaking change
-D) custom — 직접 입력
+A) patch (v{CURRENT +0.0.1}) - bug fix / small refactor
+B) minor (v{CURRENT +0.1.0}) - 새 기능, backward compatible
+C) major (v{CURRENT +1.0.0}) - breaking change
+D) custom - 직접 입력
 ```
 
 선택된 버전을 `TARGET_VERSION` 으로 저장.
 
-### Step 2 — 버전 동기화 사전 체크
+### Step 2 - 버전 동기화 사전 체크
 
 ```bash
 npm run release:check-sync
@@ -126,7 +133,7 @@ npm run release:check-sync
 - 자동 수정 제안: `npm run release:check-sync:fix`
 - 사용자 승인 후 실행
 
-### Step 3 — 버전 bump
+### Step 3 - 버전 bump
 
 ```bash
 npm run release:bump -- --version "$TARGET_VERSION" --write
@@ -136,7 +143,7 @@ npm run release:bump -- --version "$TARGET_VERSION" --write
 
 > **MANDATORY `--write`**: 플래그 없으면 dry-run 만 동작 (`scripts/release/bump-version.mjs:28` `if (write)` 분기). `--write` 누락 시 후속 Step 이 모두 이전 버전으로 진행되는 silent failure 가 된다.
 
-### Step 4 — CHANGELOG 초안 생성
+### Step 4 - CHANGELOG 초안 생성
 
 `git log --oneline <previous-tag>..HEAD` 로 범위 커밋 나열 후, Claude 가 아래 섹션 구조로 초안 작성:
 
@@ -166,7 +173,7 @@ B) 편집하고 계속 (사용자가 에디터에서 수정 후 진행)
 C) 취소
 ```
 
-### Step 5 — 테스트 + 빌드 검증
+### Step 5 - 테스트 + 빌드 검증
 
 ```bash
 npm run release:prepare -- --execute --version "$TARGET_VERSION" --allow-dirty
@@ -186,7 +193,7 @@ npm run release:prepare -- --execute --version "$TARGET_VERSION" --allow-dirty
 
 실패 시 → **STOP**. 사용자에게 에러 보여주고 재시도 옵션 제공.
 
-### Step 6 — pack.mjs 미러
+### Step 6 - pack.mjs 미러
 
 ```bash
 node scripts/pack.mjs all
@@ -197,7 +204,7 @@ node scripts/pack.mjs all
 - `git status` 로 실제 변경 파일만 선별 스테이징
 - 예: `git add packages/triflux/` (구체 경로 지정)
 
-### Step 7 — Commit + Tag
+### Step 7 - Commit + Tag
 
 커밋 메시지 (절대 Co-Authored-By 등 포함 금지):
 
@@ -211,7 +218,7 @@ git tag "v${TARGET_VERSION}"
 
 `.gitmessage` 템플릿이 AI trailer 를 자동 주입하는 경우 제거. `--no-edit` 으로 추가 편집 차단.
 
-### Step 8 — Push
+### Step 8 - Push
 
 **AskUserQuestion** (릴리즈 전 마지막 확인):
 
@@ -220,7 +227,7 @@ git tag "v${TARGET_VERSION}"
 
 A) git push origin main --tags (권장)
 B) tag 없이 push (수동 tag 후처리)
-C) 중단 — 로컬에만 유지
+C) 중단 - 로컬에만 유지
 ```
 
 선택 A 시:
@@ -229,7 +236,7 @@ git push origin main
 git push origin "v${TARGET_VERSION}"
 ```
 
-### Step 9 — GitHub Release
+### Step 9 - GitHub Release
 
 ```bash
 NOTES_PATH=".omx/plans/release-notes-v${TARGET_VERSION}.md"
@@ -242,7 +249,7 @@ gh release create "v${TARGET_VERSION}" \
 - 노트 본문 검증: Co-Authored-By / AI trailer 포함됐는지 grep 후 제거
 - `--draft` 로 초안 생성 후 수동 publish 도 가능 (안전 모드)
 
-### Step 10 — npm publish (= CI 가 수행, 로컬 금지가 기본)
+### Step 10 - npm publish (= CI 가 수행, 로컬 금지가 기본)
 
 > **평상시 로컬에서 `npm publish` 하지 않는다.** Step 8 에서 `git push origin v<X.Y.Z>` 로 태그가 올라가면 `npm-publish.yml` 이 OIDC 로 자동 발행한다.
 > CI run 관찰: `gh run list --workflow npm-publish.yml -L1` → `gh run watch <id>`
@@ -250,10 +257,10 @@ gh release create "v${TARGET_VERSION}" \
 CI 가 완전히 불가능한 비상시에만, npm 인증을 갖춘 환경에서 수동 폴백:
 
 ```bash
-node scripts/release/publish.mjs --execute   # 비상 폴백 전용 — 중복 publish 주의
+node scripts/release/publish.mjs --execute   # 비상 폴백 전용 - 중복 publish 주의
 ```
 
-### Step 10.5 — pypi publish (future, 현재 비활성)
+### Step 10.5 - pypi publish (future, 현재 비활성)
 
 triflux 가 Python 모듈을 가지게 되면 이 단계를 활성화:
 
@@ -267,7 +274,7 @@ fi
 
 현 단계는 `pyproject.toml` 없음 → skip. 플레이스홀더만 유지.
 
-### Step 11 — 사후 검증 (3채널 전부)
+### Step 11 - 사후 검증 (3채널 전부)
 
 ```bash
 npm run release:verify
@@ -280,7 +287,7 @@ npm run release:verify
 - 릴리즈 노트 공개됨 (`gh release view v${TARGET_VERSION}`)
 - (future) pypi 는 pyproject.toml 있을 때만 체크
 
-### Step 12 — 사용자 알림
+### Step 12 - 사용자 알림
 
 ```
 RELEASE COMPLETE ✓
@@ -300,7 +307,7 @@ github:  https://github.com/tellang/triflux/releases/tag/v${TARGET_VERSION}
 | 단계 | 에러 | 복구 |
 |------|------|------|
 | Step 0 | 브랜치가 main 아님 | `git checkout main` 또는 PR 플로우 |
-| Step 0 | unpushed 커밋 있음 (ship 전 확인) | 정상 — 릴리즈 대상 |
+| Step 0 | unpushed 커밋 있음 (ship 전 확인) | 정상 - 릴리즈 대상 |
 | Step 0 | uncommitted 변경 | 먼저 커밋 / ship 에 흡수 / 취소 선택 |
 | Step 2 | 버전 동기화 실패 | `release:check-sync --fix` 실행 |
 | Step 5 | 테스트 실패 | 수정 후 재시도. `--skip-tests` 는 위험 |
@@ -308,7 +315,7 @@ github:  https://github.com/tellang/triflux/releases/tag/v${TARGET_VERSION}
 | Step 7 | commit 메시지에 AI trailer 감지 | 하드 차단 + 재작성 요청 |
 | Step 8 | push 거부 (remote 변경됨) | `git pull --rebase origin main` 후 재시도 |
 | Step 9 | gh release create 실패 | `gh auth status` 확인, 수동 재시도 |
-| Step 10 | npm publish(CI) 실패 | `gh run view <id> --log-failed` 로 `npm-publish.yml` 로그 확인. `NPM_TOKEN` secret / OIDC 설정 점검 |
+| Step 10 | npm publish(CI) 실패 | `gh run view <id> --log-failed` 로 `npm-publish.yml` 로그 확인. 세 패키지의 OIDC Trusted Publisher 설정 점검 |
 
 ## 플래그
 
@@ -345,5 +352,5 @@ github:  https://github.com/tellang/triflux/releases/tag/v${TARGET_VERSION}
 - 버전 불일치: `npm run release:check-sync --fix`
 - pack CRLF 경고: 실제 변경 파일만 선별 `git add packages/triflux/...`
 - gh CLI 미인증: `gh auth login` (또는 gh 정상인 머신/웹 UI 로 release.yml dispatch)
-- npm publish 는 CI(`npm-publish.yml`, OIDC)가 수행 — 로컬 `npm login` 불필요. CI 실패 시 `gh run view <id> --log-failed`
+- npm publish 는 CI(`npm-publish.yml`, OIDC)가 수행 - 로컬 `npm login` 불필요. CI 실패 시 `gh run view <id> --log-failed`
 - prepare.mjs stall: `scripts/release/prepare.mjs` 가 `stdio: ["ignore","pipe","pipe"]` + 10분 timeout 적용됨 (v10.9.32 fix 739da2d)

package/tui/codex-profile.mjs

@@ -41,9 +41,8 @@ const CONFIG_PATH = join(CODEX_DIR, "config.toml");
 
 const KNOWN_MODELS = [
   { label: "gpt-6-astra", hint: "프런티어" },
-  { label: "gpt-5.6-sol", hint: "범용" },
-  { label: "gpt-5.6-terra", hint: "표준" },
-  { label: "gpt-5.6-luna", hint: "경량" },
+  { label: "gpt-6-sol", hint: "범용" },
+  { label: "gpt-6-luna", hint: "경량" },
   { label: "직접 입력", hint: "" },
 ];
 

package/tui/setup.mjs

@@ -39,9 +39,10 @@ const REQUIRED_CODEX_PROFILE_NAMES = [
   "gpt6_astra_ultra",
   "gpt6_astra_max",
   "gpt6_astra_xhigh",
-  "gpt56_terra_high",
-  "gpt56_terra_med",
-  "gpt56_luna_low",
+  "gpt6_sol_high",
+  "gpt6_sol_med",
+  "gpt6_luna_high",
+  "gpt6_luna_low",
 ];
 
 const STABLE_NODE_COMMAND_CANDIDATES = Object.freeze([

package/hub/team/git-preflight.mjs

@@ -1,286 +0,0 @@
-// hub/team/git-preflight.mjs — Pre-flight safety check for dangerous git ops.
-// Blocks checkout/rebase/cherry-pick/reset/stash-pop/worktree-remove when they
-// would conflict with other active Synapse sessions' dirty files or claimed
-// leases. Fail-open by default: if registry/locks are unavailable, allow the op
-// with a warning (worktree isolation is the baseline safety net).
-
-/**
- * Factory for git pre-flight check.
- *
- * @param {object} opts
- * @param {{ getActive: () => Array<object> }} opts.registry — synapse-registry duck type
- * @param {{ snapshot: () => Array<object> }} opts.locks — swarm-locks duck type
- * @param {boolean} [opts.failOpen=true] — allow op when registry/locks throw or are missing
- * @param {(level: string, msg: string, data?: object) => void} [opts.logger] — optional logger
- * @returns {{
- *   check: Function,
- *   checkRebase: Function,
- *   checkCheckout: Function,
- *   checkCherryPick: Function,
- *   checkReset: Function,
- *   checkStashPop: Function,
- *   checkWorktreeRemove: Function,
- * }}
- */
-export function createGitPreflight(opts = {}) {
-  const { registry, locks, failOpen = true, logger = null } = opts;
-
-  function log(level, msg, data) {
-    if (logger) {
-      try {
-        logger(level, msg, data);
-      } catch {
-        /* logger failure is non-fatal */
-      }
-      return;
-    }
-    if (level === "warn") {
-      console.warn(`[git-preflight] ${msg}`, data ?? "");
-    } else if (level === "error") {
-      console.error(`[git-preflight] ${msg}`, data ?? "");
-    }
-  }
-
-  // ── helpers ──────────────────────────────────────────────
-
-  function safeGetActive() {
-    try {
-      const value = registry?.getActive?.();
-      if (!Array.isArray(value)) return null;
-      return value;
-    } catch (err) {
-      log("warn", "registry.getActive threw", { error: err?.message });
-      return null;
-    }
-  }
-
-  function safeSnapshot() {
-    try {
-      const value = locks?.snapshot?.();
-      if (!Array.isArray(value)) return null;
-      return value;
-    } catch (err) {
-      log("warn", "locks.snapshot threw", { error: err?.message });
-      return null;
-    }
-  }
-
-  function failOpenDecision(reason) {
-    log("warn", "hub unavailable, failing open", { reason });
-    return { allowed: true, reason: "hub_unavailable_fail_open" };
-  }
-
-  function normalizeFiles(list) {
-    if (!Array.isArray(list)) return new Set();
-    return new Set(
-      list
-        .filter((f) => typeof f === "string" && f.length > 0)
-        .map((f) => f.replace(/\\/g, "/")),
-    );
-  }
-
-  function otherActiveSessions(active, sessionId) {
-    return active.filter((s) => s?.sessionId && s.sessionId !== sessionId);
-  }
-
-  function otherLeases(snapshot, workerId) {
-    return snapshot.filter(
-      (entry) => entry?.workerId && entry.workerId !== workerId,
-    );
-  }
-
-  function buildConflict(file, session, holder) {
-    return {
-      file,
-      activeSession: session?.sessionId ?? holder ?? "unknown",
-      activeTask: session?.taskSummary ?? "",
-      ...(holder ? { leaseHolder: holder } : {}),
-    };
-  }
-
-  function recommend(conflicts) {
-    if (!conflicts.length) return "";
-    const first = conflicts[0];
-    const owner = first.leaseHolder || first.activeSession;
-    const task = first.activeTask ? ` Active task: '${first.activeTask}'` : "";
-    return `Wait for '${owner}' to finish, or coordinate via HITL.${task}`;
-  }
-
-  function blockedDecision(op, conflicts, extraReason) {
-    return {
-      allowed: false,
-      reason: extraReason || "overlap_with_active_session",
-      conflicts,
-      recommendation: recommend(conflicts),
-      op,
-    };
-  }
-
-  function allowedDecision() {
-    return { allowed: true };
-  }
-
-  // ── shared scanners ─────────────────────────────────────
-
-  function findDirtyFileConflicts(sessionId, workerId) {
-    const active = safeGetActive();
-    const snapshot = safeSnapshot();
-
-    if (active == null || snapshot == null) {
-      return failOpen ? { fallOpen: true } : { fallOpen: false, conflicts: [] };
-    }
-
-    const conflicts = [];
-    const seen = new Set();
-
-    for (const session of otherActiveSessions(active, sessionId)) {
-      const dirty = normalizeFiles(session.dirtyFiles);
-      for (const file of dirty) {
-        if (seen.has(file)) continue;
-        seen.add(file);
-        conflicts.push(buildConflict(file, session));
-      }
-    }
-
-    for (const lease of otherLeases(snapshot, workerId)) {
-      if (lease.leaseType && lease.leaseType !== "exclusive") continue;
-      const file = typeof lease.file === "string" ? lease.file : null;
-      if (!file || seen.has(file)) continue;
-      seen.add(file);
-      const sessionMeta = lease.sessionMeta || null;
-      conflicts.push(
-        buildConflict(
-          file,
-          sessionMeta
-            ? {
-                sessionId: sessionMeta.sessionId || lease.workerId,
-                taskSummary: sessionMeta.taskSummary || "",
-              }
-            : null,
-          lease.workerId,
-        ),
-      );
-    }
-
-    return { conflicts };
-  }
-
-  function findTargetFileConflicts(targetFiles, sessionId, workerId) {
-    const active = safeGetActive();
-    const snapshot = safeSnapshot();
-
-    if (active == null || snapshot == null) {
-      return failOpen ? { fallOpen: true } : { fallOpen: false, conflicts: [] };
-    }
-
-    const targets = normalizeFiles(targetFiles);
-    if (targets.size === 0) return { conflicts: [] };
-
-    const conflicts = [];
-    const seen = new Set();
-
-    for (const session of otherActiveSessions(active, sessionId)) {
-      const dirty = normalizeFiles(session.dirtyFiles);
-      for (const file of dirty) {
-        if (!targets.has(file) || seen.has(file)) continue;
-        seen.add(file);
-        conflicts.push(buildConflict(file, session));
-      }
-    }
-
-    for (const lease of otherLeases(snapshot, workerId)) {
-      if (lease.leaseType && lease.leaseType !== "exclusive") continue;
-      const file = typeof lease.file === "string" ? lease.file : null;
-      if (!file || !targets.has(file) || seen.has(file)) continue;
-      seen.add(file);
-      const sessionMeta = lease.sessionMeta || null;
-      conflicts.push(
-        buildConflict(
-          file,
-          sessionMeta
-            ? {
-                sessionId: sessionMeta.sessionId || lease.workerId,
-                taskSummary: sessionMeta.taskSummary || "",
-              }
-            : null,
-          lease.workerId,
-        ),
-      );
-    }
-
-    return { conflicts };
-  }
-
-  // ── public API ──────────────────────────────────────────
-
-  /**
-   * Core pre-flight check.
-   *
-   * @param {"checkout"|"rebase"|"cherry-pick"|"reset"|"stash-pop"|"worktree-remove"} op
-   * @param {{ targetFiles?: string[], branch?: string, ref?: string, worktreePath?: string }} args
-   * @param {{ sessionId: string, workerId?: string }} sessionContext
-   * @returns {{ allowed: boolean, reason?: string, conflicts?: object[], recommendation?: string, op?: string }}
-   */
-  function check(op, args = {}, sessionContext = {}) {
-    const sessionId = sessionContext.sessionId || "";
-    const workerId = sessionContext.workerId || sessionId;
-
-    switch (op) {
-      case "checkout":
-      case "rebase":
-      case "reset":
-      case "stash-pop": {
-        const res = findDirtyFileConflicts(sessionId, workerId);
-        if (res.fallOpen) return failOpenDecision(op);
-        if (res.conflicts.length > 0) return blockedDecision(op, res.conflicts);
-        return allowedDecision();
-      }
-      case "cherry-pick": {
-        const targets = Array.isArray(args.targetFiles) ? args.targetFiles : [];
-        const res = findTargetFileConflicts(targets, sessionId, workerId);
-        if (res.fallOpen) return failOpenDecision(op);
-        if (res.conflicts.length > 0) return blockedDecision(op, res.conflicts);
-        return allowedDecision();
-      }
-      case "worktree-remove": {
-        const active = safeGetActive();
-        if (active == null) return failOpenDecision(op);
-        const target =
-          typeof args.worktreePath === "string"
-            ? args.worktreePath.replace(/\\/g, "/")
-            : "";
-        if (!target) return allowedDecision();
-        const conflicts = [];
-        for (const session of otherActiveSessions(active, sessionId)) {
-          const sessionPath =
-            typeof session.worktreePath === "string"
-              ? session.worktreePath.replace(/\\/g, "/")
-              : "";
-          if (sessionPath && sessionPath === target) {
-            conflicts.push({
-              file: target,
-              activeSession: session.sessionId,
-              activeTask: session.taskSummary || "",
-            });
-          }
-        }
-        if (conflicts.length > 0) {
-          return blockedDecision(op, conflicts, "active_worktree");
-        }
-        return allowedDecision();
-      }
-      default:
-        return allowedDecision();
-    }
-  }
-
-  return Object.freeze({
-    check,
-    checkRebase: (args, ctx) => check("rebase", args, ctx),
-    checkCheckout: (args, ctx) => check("checkout", args, ctx),
-    checkCherryPick: (args, ctx) => check("cherry-pick", args, ctx),
-    checkReset: (args, ctx) => check("reset", args, ctx),
-    checkStashPop: (args, ctx) => check("stash-pop", args, ctx),
-    checkWorktreeRemove: (args, ctx) => check("worktree-remove", args, ctx),
-  });
-}