agent-work-loop 0.6.46 → 0.6.48

package/README.md

@@ -1,13 +1,32 @@
 # agent-work-loop
 
-`agent-work-loop`(명령어: `awl`)은 AI 에이전트가 같은 실패를 두 번 반복하지 않도록 돕는 도구입니다. 에이전트가 작업하며 남긴 기록, 검증 결과, 완료 조건, 규칙, 교훈, 막힘을 파일로 관리합니다.
+[![npm version](https://img.shields.io/npm/v/agent-work-loop.svg)](https://www.npmjs.com/package/agent-work-loop)
+[![CI](https://github.com/kh1012/agent-work-loop/actions/workflows/ci.yml/badge.svg)](https://github.com/kh1012/agent-work-loop/actions/workflows/ci.yml)
+[![release](https://img.shields.io/github/v/tag/kh1012/agent-work-loop?label=release&sort=semver)](https://github.com/kh1012/agent-work-loop/tags)
+[![license](https://img.shields.io/npm/l/agent-work-loop.svg)](LICENSE)
 
-이 README는 **실용 문서**입니다. 설치부터 첫 루프까지, 손으로 따라 할 수 있는 순서만 다룹니다. "왜 이렇게 만들었는가"(하네스 개념, 게이트 위치, narrative 실증 사례)는 [`docs/presentation/storyline.md`](docs/presentation/storyline.md)에 따로 정리했습니다. 명령어 하나하나의 자세한 사용법은 [`docs/presentation/commands.md`](docs/presentation/commands.md)를 참고하세요.
+`agent-work-loop`(명령어: `awl`)은 AI 에이전트가 같은 실패를 두 번 반복하지 않도록 돕는 도구입니다. 에이전트가 작업하며 남긴 기록, 검증 결과, 완료 조건, 규칙, 교훈, 막힘을 파일로 관리합니다.
 
 **awl 자체는 판단하지 않습니다.** LLM을 호출하지 않고, 파일과 상태만 결정적으로 다룹니다. 무엇을 배우고 어떤 규칙을 세울지는 이미 설치된 에이전트(Claude Code, Codex)가 스킬로 판단합니다.
 
+이 README는 **실용 문서**입니다. 설치부터 첫 루프까지, 손으로 따라 할 수 있는 순서만 다룹니다. "왜 이렇게 만들었는가"(하네스 개념, 게이트 위치, narrative 실증 사례)는 [`docs/presentation/storyline.md`](docs/presentation/storyline.md)에, 명령어 하나하나의 자세한 사용법은 [`docs/presentation/commands.md`](docs/presentation/commands.md)에 정리했습니다.
+
 크로스 환경을 처음부터 전제로 합니다. macOS와 Windows, Claude Code와 Codex를 모두 지원하는 것을 목표로 합니다(Windows는 아직 macOS만큼 검증되지 않았습니다. [알려진 위험](docs/decisions.md)을 참고하세요).
 
+## 목차
+
+- [언제 쓰나](#언제-쓰나)
+- [설치](#설치)
+- [5분 시작](#5분-시작)
+- [LLM과 함께 실제로 쓰는 시나리오](#llm과-함께-실제로-쓰는-시나리오)
+- [명령어 요약](#명령어-요약)
+- [설정(config): 검증 명령과 모노레포](#설정config-검증-명령과-모노레포)
+- [무엇이 어디에 쌓이나](#무엇이-어디에-쌓이나)
+- [워크아이템 병행](#워크아이템-병행)
+- [오케스트레이션 파이프라인: 여러 레인을 나란히](#오케스트레이션-파이프라인-여러-레인을-나란히)
+- [문제 해결](#문제-해결)
+- [기여하기](#기여하기)
+
 ---
 
 ## 언제 쓰나
@@ -35,32 +54,26 @@ yarn global add agent-work-loop
 
 > **pnpm 함정**: pnpm으로 전역 설치하면 `awl` 명령을 찾을 수 없다는 에러가 날 수 있습니다. pnpm의 전역 bin 디렉토리가 PATH에 없어서입니다. `pnpm setup`을 한 번 실행하고 터미널을 새로 열면 해결됩니다.
 
-> **팀 내부 설치(지금 당장 필요하면)**: 이 README를 작성하는 시점 기준으로 npm 레지스트리의 `agent-work-loop`는 아직 `0.0.0`(이름 예약용 placeholder)만 배포돼 있어 `npm install -g agent-work-loop`로는 동작하는 CLI가 설치되지 않습니다. 지금 바로 써야 한다면 이 저장소를 클론해 직접 빌드·링크하세요.
-> ```bash
-> git clone <이 저장소> && cd agent-work-loop
-> pnpm install && pnpm run build
-> pnpm link --global   # 또는: npm link
-> ```
-> `dist/cli.js`가 `awl` bin으로 등록됩니다. 정식 npm 배포가 되면 이 문단은 지웁니다.
+저장소를 직접 빌드해서 쓰고 싶다면(기여하거나 배포 전 최신 상태를 바로 써보고 싶을 때):
 
-### 업데이트 하기
-
-```
-업데이트 하기:
-  1. npm i -g agent-work-loop@latest    npm에 배포된 최신 버전을 받습니다
-  2. awl update                         설치된 패키지로 전역 엔진(~/.awl/engine)을 갱신합니다
+```bash
+git clone https://github.com/kh1012/agent-work-loop.git && cd agent-work-loop
+pnpm install && pnpm run build
+pnpm link --global   # 또는: npm link
 ```
 
-pnpm이나 yarn을 쓴다면 1번만 그 도구로 바꿉니다:
+`dist/cli.js`가 `awl` bin으로 등록됩니다.
 
-```bash
-pnpm add -g agent-work-loop@latest
-yarn global add agent-work-loop@latest
+### 업데이트 하기
+
+```
+1. npm i -g agent-work-loop@latest    npm에 배포된 최신 버전을 받습니다
+2. awl update                         설치된 패키지로 전역 엔진(~/.awl/engine)을 갱신합니다
 ```
 
-`awl update`(옵션 없음)는 `awl update --global`과 같습니다. 전역 엔진만 갱신하고 어떤 프로젝트도 건드리지 않습니다. 대부분은 이 두 줄이면 끝입니다.
+pnpm이나 yarn을 쓴다면 1번만 그 도구로 바꿉니다. `awl update`(옵션 없음)는 `awl update --global`과 같습니다. 전역 엔진만 갱신하고 어떤 프로젝트도 건드리지 않습니다. 대부분은 이 두 줄이면 끝입니다.
 
-**여러 프로젝트를 관리하는 입장이라면** 등록된 프로젝트들의 로컬 스킬(`.claude/skills`, `AGENTS.md`, `.awl/config.json`)까지 한 번에 맞추고 싶을 수 있습니다:
+**여러 프로젝트를 관리하는 입장이라면** 등록된 프로젝트들의 로컬 스킬(`.claude/skills`, `AGENTS.md`, `.awl/config.json`)까지 한 번에 맞추고 싶을 수 있습니다.
 
 ```bash
 npm i -g agent-work-loop@latest
@@ -71,12 +84,12 @@ awl update --all
 
 이렇게 갱신한 프로젝트를 커밋해서 push하면, 그 저장소를 쓰는 다른 사람들은 다음에 pull할 때 최신 스킬을 받습니다. **다만 자동으로 알림이 가는 구조는 아닙니다.** 각자 컴퓨터의 `~/.awl/engine`이 낡았는지는 그 사람이 `awl doctor`/`awl version-check`를 실행하거나 `/awl-loop`·`/awl-pipeline`을 실행할 때(버전 확인이 맨 처음 단계로 들어있습니다) 노란 경고로 보게 됩니다.
 
-설치가 됐는지 확인합니다:
+설치가 됐는지 확인합니다.
 
 ```bash
 $ awl doctor
 
-+- Agent Work Loop · 진단 ------------------------------------------------------------------+
++  Agent Work Loop · 진단
 |  환경
 |  |-- Node: v22.22.2  [ok]
 |  |-- 플랫폼: darwin arm64  [ok]
@@ -92,10 +105,10 @@ $ awl doctor
 |
 |  에이전트
 |  |-- Claude Code: 없음
-|  |-- Codex: 없음
+|  `-- Codex: 없음
 |
 |  [x] 문제 2개. awl init 을 실행하세요.
-+-------------------------------------------------------------------------------------------+
++
 ```
 
 터미널이 유니코드/색을 지원하면(Windows Terminal, VS Code 터미널 등) 자동으로 감지해 상자 그림과 색을 씁니다. 지원 안 되면 위처럼 ASCII로 자동 전환됩니다. `doctor`는 아무것도 고치지 않습니다. 점검만 합니다.
@@ -111,22 +124,26 @@ $ cd my-project
 $ awl init
 ```
 
-질문 없이 감지된 값으로 바로 진행하려면 `awl init --yes`를 씁니다. 실제 출력(스크래치 프로젝트, `--yes`):
+질문 없이 감지된 값으로 바로 진행하려면 `awl init --yes`를 씁니다. 실제 출력:
 
 ```
-+- 설정 완료 ---------------------------------------------------------------+
-|    ~/.awl              생성됨                                             |
-|    ~/.awl/engine       0.6.18                                             |
-|    .awl/config.json    생성됨    <- 커밋하세요. 팀원은 이 파일을 씁니다   |
-|    .awl/state.json     gitignore 에 추가함    [ok] git push 차단 훅 설치  |
-|  규칙 0개 · 교훈 0개 · 등록된 프로젝트 1개 · 1세대                        |
-+---------------------------------------------------------------------------+
-
-+- 다음 단계 ----------------------------------------------------+
-|  Claude Code 를 열고 이렇게 말하세요.                          |
-|                                                                |
-|  /awl-loop  페이지 편집기에 여백 시스템을 넣고 싶어            |
-+----------------------------------------------------------------+
++  설정 완료
+|  [v0.6.46]
+|    ~/.awl              생성됨
+|    ~/.awl/engine       0.6.46
+|    .awl/config.json    생성됨    <- 커밋하세요. 팀원은 이 파일을 씁니다
+|    .awl/state.json     gitignore 에 추가함    [ok] git push 차단 훅 설치
+|  규칙 0개 · 교훈 0개 · 등록된 프로젝트 1개 · 1세대
++
+
++  다음 단계
+|  Claude Code 를 열고 이렇게 말하세요.
+|
+|  /awl-loop  페이지 편집기에 여백 시스템을 넣고 싶어
+|
+|  /awl-pipeline <레인명> --gl 을 실행해보세요.
+|  (격리된 작업 세션이 생성되며, 자율 모드로 실행됩니다.)
++
 ```
 
 대화형 모드(`--yes` 없이)는 3단계 화면(1/3 주 언어 → 2/3 검증 명령어 → 3/3 규칙과 이 프로젝트의 성격)을 방향키(또는 번호)로 물은 뒤, 설치할 에이전트를 고르는 스킬 화면을 보여줍니다.
@@ -150,6 +167,13 @@ $ awl init
 awl status    # 지금 어디까지 왔는지 한눈에
 ```
 
+명령어 전체와 스킬(`/awl-loop`·`/awl-pipeline`) 부연설명은 CLI 안에서도 바로 볼 수 있습니다.
+
+```bash
+awl --examples   # 자주 쓰는 명령 예시
+awl --skills     # /awl-loop·/awl-pipeline·레인·게이트 밀도(<mode>) 설명
+```
+
 ---
 
 ## LLM과 함께 실제로 쓰는 시나리오
@@ -198,10 +222,10 @@ awl status    # 지금 어디까지 왔는지 한눈에
 ```bash
 awl records --json     # 있었던 일 전수(타입·워크아이템으로 필터 가능)
 awl gotchas            # 아직 규칙 안 된 교훈
-awl rules              # 이 프로젝트에 적용되는 규칙
-awl metrics --compare  # 워크아이템 세대별 지표 추세
-awl brief              # 오늘(KST) 진행분만 모아 보기
-awl defer-summary      # gate-medium/gate-low에서 보류된 중요 항목 최종 확인
+awl rules               # 이 프로젝트에 적용되는 규칙
+awl metrics --compare   # 워크아이템 세대별 지표 추세
+awl brief               # 오늘(KST) 진행분만 모아 보기
+awl defer-summary       # gate-medium/gate-low에서 보류된 중요 항목 최종 확인
 ```
 
 `~/.awl`을 직접 열어보면 이렇게 생겼습니다.
@@ -223,7 +247,7 @@ awl defer-summary      # gate-medium/gate-low에서 보류된 중요 항목 최
 
 ## 명령어 요약
 
-자주 쓰는 것만 적습니다. 25개 명령(사람용 17 + 스킬용 8) 전부와 실제 실행 예시는 [`commands.md`](docs/presentation/commands.md)에 있습니다.
+자주 쓰는 것만 적습니다. 전체 명령과 실제 실행 예시는 [`commands.md`](docs/presentation/commands.md)에, `awl --examples`로도 바로 볼 수 있습니다.
 
 ```bash
 awl status    # 지금 어디까지 왔는지
@@ -245,7 +269,7 @@ awl feedback-log  # awl 도구 자체에 남겨진 피드백 기록 검토
 ```json
 {
   "project": "my-project",
-  "mainLanguage": "typescript",
+  "mainLanguage": ["typescript"],
   "character": "디자인 토큰 강제, 여백은 자유 px 금지",
   "verify": {
     "typecheck": { "cmd": "tsc --noEmit" },
@@ -286,11 +310,11 @@ $ awl config set verify.typecheck.cwd packages/app
 |---|---|---|
 | 담는 것 | 엔진(스킬 템플릿), 규칙, 교훈(gotcha), 기록(records), 등록된 프로젝트 목록 | 이 프로젝트의 설정(config.json), 지금 루프 위치(state.json) |
 | 누구 것인가 | **당신**. 프로젝트를 옮겨 다녀도 따라옵니다 | **이 프로젝트**. 리포지토리를 나가면 안 따라옵니다 |
-| git 커밋 | 대상 아님(홈 디렉토리) | `config.json`은 커밋, `state.json`은 gitignore |
+| git 커밋 | 대상 아님(홈 디렉토리) | 프로젝트마다 다름 — `state.json`은 항상 gitignore, `config.json`은 팀 컨벤션에 따라 커밋하거나 로컬 전용으로 gitignore할 수 있습니다 |
 
 두 층으로 나눈 이유(다음 프로젝트에서 빈손으로 시작하지 않기 위해)와 규칙/교훈이 어떻게 승격되는지는 [`storyline.md` 4절·5절](docs/presentation/storyline.md)에서 다룹니다. `AWL_HOME` 환경변수로 전역 위치를 바꿀 수 있습니다(테스트·CI에서 유용합니다).
 
-규칙 승격은 사람이 직접 합니다(자동 승격 없음):
+규칙 승격은 사람이 직접 합니다(자동 승격 없음).
 
 ```bash
 awl rules promote G-003 \
@@ -298,7 +322,7 @@ awl rules promote G-003 \
   --counter "이미 디자인 토큰 시스템이 없는 프로젝트"
 ```
 
-교훈(gotcha, `~/.awl/gotchas`)과 awl 도구 자체 피드백(`~/.awl/records`, `awl record awl-feedback`)은 다른 종류입니다. 전자는 작업 대상 코드에 대한 것이고, 후자는 "awl commit이 이래서 아팠다" 같은 도구 자체의 문제입니다.
+교훈(gotcha, `~/.awl/gotchas`)과 awl 도구 자체 피드백(`~/.awl/records`, `awl record awl-feedback`)은 다른 종류입니다. 전자는 작업 대상 코드에 대한 것이고, 후자는 "awl commit이 이래서 아팠다" 같은 도구 자체의 문제입니다. `awl feedback-log`로 모아 봅니다.
 
 ---
 
@@ -335,9 +359,6 @@ awl work switch <ID>       # 보관된 워크아이템으로 전환
 **`awl: command not found` (pnpm 설치 후)**
 `pnpm setup`을 실행하고 터미널을 새로 엽니다. pnpm 전역 bin이 PATH에 없어서입니다.
 
-**`npm install -g agent-work-loop`를 했는데 `awl`이 아무것도 못 한다**
-위 설치 섹션을 참고하세요. 아직 npm에 `0.0.0` placeholder만 배포돼 있습니다. 저장소를 클론해 `pnpm install && pnpm run build && pnpm link --global`로 설치하세요.
-
 **`awl --version`이 엔진 버전 불일치를 경고한다**
 `awl`을 업그레이드했는데 `~/.awl/engine`은 예전 버전 그대로일 때 나옵니다. `awl update`로 엔진을 갱신하면 맞춰집니다(프로젝트 설정은 안 건드립니다). `awl version-check`로 어긋난 버전 쌍(package.json, 설치된 엔진, 프로젝트 config, 설치된 스킬)을 직접 봅니다. 프로젝트 config가 엔진보다 낡았다면 `awl init --yes`를 다시 실행합니다.
 
@@ -357,10 +378,7 @@ awl work switch <ID>       # 보관된 워크아이템으로 전환
 `awl init`이 심는 pre-push 훅 때문입니다(위 5분 시작 참고). 실제 터미널에서 사람이 직접 치는 push는 막히지 않습니다 — 막혔다면 비대화형(에이전트, CI, 스크립트)으로 실행된 경우이고, 그때는 `AWL_ALLOW_PUSH=1 git push`를 씁니다.
 
 **대형 저장소에서 `awl lane new`/`awl work new --worktree`가 `Could not write new index file`로 실패한다**
-`git worktree add`가 기본 180초 안에 못 끝나 강제 종료됐다는 뜻입니다(대형 모노레포는
-체크아웃이 오래 걸립니다) — 디스크 문제가 아닙니다. `AWL_GIT_WORKTREE_TIMEOUT_MS=<ms>`
-환경변수로 값을 늘려 다시 시도하세요(예: `AWL_GIT_WORKTREE_TIMEOUT_MS=300000 awl lane new
-<이름>`).
+`git worktree add`가 기본 180초 안에 못 끝나 강제 종료됐다는 뜻입니다(대형 모노레포는 체크아웃이 오래 걸립니다) — 디스크 문제가 아닙니다. `AWL_GIT_WORKTREE_TIMEOUT_MS=<ms>` 환경변수로 값을 늘려 다시 시도하세요(예: `AWL_GIT_WORKTREE_TIMEOUT_MS=300000 awl lane new <이름>`).
 
 **게이트에서 스킬이 안 멈추고 그냥 진행한다**
 스킬 문서가 게이트에서 반드시 도구를 호출하도록 지시돼 있습니다. 계속 안 멈추면 스킬이 최신인지 확인하세요. `awl doctor`가 `claude-skill-vs-engine` 불일치를 경고하면 `awl init --yes`로 재설치합니다.
@@ -370,7 +388,7 @@ awl work switch <ID>       # 보관된 워크아이템으로 전환
 
 ---
 
-## 기여 / 라이선스
+## 기여하기
 
 이 저장소는 pnpm을 사용합니다.
 
@@ -382,8 +400,10 @@ pnpm run lint     # biome 검사
 pnpm run typecheck
 ```
 
+PR을 올리면 [GitHub Actions](.github/workflows/ci.yml)가 Node 18/22 두 버전에서 typecheck·lint·test·build를 자동으로 돌립니다.
+
 릴리스는 `pnpm release:patch` / `pnpm release:minor` / `pnpm release:major`로 합니다. 검증·빌드·tarball·`npm publish --dry-run`을 통과한 뒤 버전, CHANGELOG, 커밋, 태그, 원격 push를 한 번에 처리합니다. **`npm publish`만 사람이 실행합니다.**
 
 npm에 `awl` 패키지가 이미 있어, 패키지 이름은 `agent-work-loop`로 배포하고 명령어 이름만 `awl`로 씁니다.
 
-라이선스는 MIT입니다.
+라이선스는 [MIT](LICENSE)입니다.

package/dist/{brief-SGMFXOY2.js → brief-ODMUS5B3.js}

@@ -1,15 +1,15 @@
 import {
   loadProjectName,
   readRecords
-} from "./chunk-FK3Q7UY2.js";
+} from "./chunk-2NETKDCV.js";
 import {
   loadState
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   resolveProjectRoot,
   run
-} from "./chunk-MLTY3EE6.js";
-import "./chunk-SJG22DAK.js";
+} from "./chunk-FLVRMRHX.js";
+import "./chunk-IPNBHVGX.js";
 import "./chunk-FGHILN3D.js";
 
 // src/commands/brief.ts

package/dist/{changelog-VNJ4EQ74.js → changelog-P35RSRT3.js}

@@ -1,13 +1,13 @@
 import {
   readRecords
-} from "./chunk-FK3Q7UY2.js";
+} from "./chunk-2NETKDCV.js";
 import {
   loadState
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   resolveProjectRoot
-} from "./chunk-MLTY3EE6.js";
-import "./chunk-SJG22DAK.js";
+} from "./chunk-FLVRMRHX.js";
+import "./chunk-IPNBHVGX.js";
 import {
   caps,
   signal

package/dist/{chunk-FK3Q7UY2.js → chunk-2NETKDCV.js}

@@ -2,11 +2,11 @@ import {
   getCriterion,
   loadState,
   writeState
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   resolveProjectRoot,
   run
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   caps,
   makeColors,

package/dist/{chunk-XWMS6Z5E.js → chunk-AVIUMBJZ.js}

@@ -3,14 +3,14 @@ import {
   getLatestVersionCached,
   name,
   version
-} from "./chunk-ZEX5ZF6C.js";
+} from "./chunk-HW2OSIB3.js";
 import {
   resolveProjectRoot
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   packageEngineDir,
   skillsVersionPath
-} from "./chunk-SJG22DAK.js";
+} from "./chunk-IPNBHVGX.js";
 import {
   caps,
   installedEngineVersion,

package/dist/{chunk-MLTY3EE6.js → chunk-FLVRMRHX.js}

@@ -13,7 +13,7 @@ import {
   selectSingle,
   step,
   verifyStepLines
-} from "./chunk-SJG22DAK.js";
+} from "./chunk-IPNBHVGX.js";
 import {
   caps,
   findProjectRoot,

package/dist/{chunk-PUINOFOR.js → chunk-FPNV5L3Y.js}

@@ -1,14 +1,14 @@
 import {
   readRecords
-} from "./chunk-FK3Q7UY2.js";
+} from "./chunk-2NETKDCV.js";
 import {
   loadState
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   multiProjectFooter,
   resolveProjectScope,
   run
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   WORKTREES_DIR,
   caps,

package/dist/{chunk-ZEX5ZF6C.js → chunk-HW2OSIB3.js}

@@ -4,7 +4,7 @@ import {
 
 // package.json
 var name = "agent-work-loop";
-var version = "0.6.46";
+var version = "0.6.48";
 
 // src/core/npm-registry.ts
 import fs from "fs";

package/dist/{chunk-SJG22DAK.js → chunk-IPNBHVGX.js}

@@ -531,9 +531,38 @@ function ensureGitignore(projectRoot) {
   fs.writeFileSync(gi, content);
   return "added";
 }
+function safetyHookPath(projectRoot) {
+  const dotGit = path.join(projectRoot, ".git");
+  const dotGitStat = fs.statSync(dotGit);
+  if (dotGitStat.isDirectory()) {
+    return path.join(dotGit, "hooks", "pre-push");
+  }
+  if (!dotGitStat.isFile()) {
+    throw new Error(`${dotGit} is neither a directory nor a gitdir file`);
+  }
+  const gitdirMatch = fs.readFileSync(dotGit, "utf8").match(/^gitdir:\s*(.+?)\s*$/m);
+  if (!gitdirMatch) {
+    throw new Error(`${dotGit} does not contain a gitdir: line`);
+  }
+  const gitdir = gitdirMatch[1];
+  if (!gitdir) {
+    throw new Error(`${dotGit} has an empty gitdir: line`);
+  }
+  const worktreeGitDir = path.resolve(path.dirname(dotGit), gitdir);
+  const commonDirFile = path.join(worktreeGitDir, "commondir");
+  let commonGitDir = worktreeGitDir;
+  if (exists(commonDirFile)) {
+    const commonDir = fs.readFileSync(commonDirFile, "utf8").trim();
+    if (commonDir === "") {
+      throw new Error(`${commonDirFile} is empty`);
+    }
+    commonGitDir = path.resolve(worktreeGitDir, commonDir);
+  }
+  return path.join(commonGitDir, "hooks", "pre-push");
+}
 function installSafetyHook(projectRoot) {
   try {
-    const hook = path.join(projectRoot, ".git", "hooks", "pre-push");
+    const hook = safetyHookPath(projectRoot);
     if (exists(hook))
       return { installed: false, warning: "\uAE30\uC874 pre-push \uD6C5\uC774 \uC788\uC5B4 awl \uD6C5\uC744 \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4." };
     const template = path.join(packageEngineDir(), "templates", "pre-push.sample");

package/dist/{chunk-ZRKOZQKP.js → chunk-ITZ52UYF.js}

@@ -1,16 +1,16 @@
 import {
   computeDurationMs
-} from "./chunk-IVEV5L7P.js";
+} from "./chunk-TCIRO4GU.js";
 import {
   computeCoverage,
   readRecords
-} from "./chunk-FK3Q7UY2.js";
+} from "./chunk-2NETKDCV.js";
 import {
   loadState
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   requireConfig
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   caps,
   generationsDir,

package/dist/{chunk-WWZIKKHP.js → chunk-IUXE7EG3.js}

@@ -1,20 +1,20 @@
 import {
   protectedFilesMessage
-} from "./chunk-VVZOIFL4.js";
+} from "./chunk-RTALSPLK.js";
 import {
   gitDirtyFiles
-} from "./chunk-DA27NBCS.js";
+} from "./chunk-KKFXZ3NV.js";
 import {
   applyVerificationAttempts,
   loadState,
   writeState
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   CommandNotFoundError,
   VERIFY_ORDER,
   requireConfig,
   run
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   caps,
   makeColors,

package/dist/{chunk-AGFQC2UO.js → chunk-JY3DXRXV.js}

@@ -4,37 +4,37 @@ import {
 } from "./chunk-D5OINC3G.js";
 import {
   parseRuleFile
-} from "./chunk-EHJYX57P.js";
+} from "./chunk-OQJIRLKN.js";
 import {
   nextGotchaId
-} from "./chunk-ZRKOZQKP.js";
+} from "./chunk-ITZ52UYF.js";
 import {
   buildVerifyBaseline,
   isCheckPassed,
   runVerifyChecks,
   writeVerifyBaseline
-} from "./chunk-WWZIKKHP.js";
+} from "./chunk-IUXE7EG3.js";
 import {
   gitBranch
-} from "./chunk-DA27NBCS.js";
+} from "./chunk-KKFXZ3NV.js";
 import {
   loadProjectName
-} from "./chunk-FK3Q7UY2.js";
+} from "./chunk-2NETKDCV.js";
 import {
   loadState,
   migrateState,
   writeState
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   loadConfig,
   multiProjectFooter,
   resolveProjectRoot,
   resolveProjectScope,
   run
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   installClaudeSkill
-} from "./chunk-SJG22DAK.js";
+} from "./chunk-IPNBHVGX.js";
 import {
   caps,
   feedback,

package/dist/{chunk-DA27NBCS.js → chunk-KKFXZ3NV.js}

@@ -1,25 +1,25 @@
 import {
   loadProjectName,
   readRecords
-} from "./chunk-FK3Q7UY2.js";
+} from "./chunk-2NETKDCV.js";
 import {
   loadState,
   readStateLock
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   gatherVersionInputs
-} from "./chunk-XWMS6Z5E.js";
+} from "./chunk-AVIUMBJZ.js";
 import {
   checkVersions
-} from "./chunk-ZEX5ZF6C.js";
+} from "./chunk-HW2OSIB3.js";
 import {
   CommandNotFoundError,
   run,
   tokenize
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   listRegisteredProjects
-} from "./chunk-SJG22DAK.js";
+} from "./chunk-IPNBHVGX.js";
 import {
   caps,
   clipToWidth,

package/dist/{chunk-EHJYX57P.js → chunk-OQJIRLKN.js}

@@ -2,7 +2,7 @@ import {
   acquireLock,
   loadGotchaList,
   releaseLock
-} from "./chunk-ZRKOZQKP.js";
+} from "./chunk-ITZ52UYF.js";
 import {
   caps,
   makeColors,

package/dist/{chunk-VVZOIFL4.js → chunk-RTALSPLK.js}

@@ -1,6 +1,6 @@
 import {
   run
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 
 // src/core/protected-files.ts
 async function changedProtectedFiles(projectRoot, protectedFiles) {

package/dist/{chunk-VE2GVNNS.js → chunk-RTZLAXTZ.js}

@@ -1,6 +1,6 @@
 import {
   resolveProjectRoot
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   caps,
   makeColors,
@@ -232,13 +232,16 @@ function runStateSet(jsonPatch, opts = {}) {
     process.exit(1);
   }
   let gateRejected = false;
+  let workitemRejected = false;
+  let activeWorkitem;
   try {
     const current = loadState(root);
-    if (p.phase === "loop" && opts.requireGateForLoop) {
-      const workitem = typeof current.workitem === "string" ? current.workitem : void 0;
-      gateRejected = !opts.requireGateForLoop(workitem);
+    activeWorkitem = typeof current.workitem === "string" ? current.workitem : void 0;
+    workitemRejected = opts.workitem !== void 0 && activeWorkitem !== opts.workitem;
+    if (!workitemRejected && p.phase === "loop" && opts.requireGateForLoop) {
+      gateRejected = !opts.requireGateForLoop(activeWorkitem);
     }
-    if (!gateRejected) {
+    if (!workitemRejected && !gateRejected) {
       const merged = mergeState(current, p);
       writeState(root, merged);
       process.stdout.write(`${JSON.stringify(merged, null, 2)}
@@ -247,6 +250,14 @@ function runStateSet(jsonPatch, opts = {}) {
   } finally {
     releaseStateLock(root, token);
   }
+  if (workitemRejected) {
+    process.stderr.write(
+      `
+  \uD65C\uC131 \uC6CC\uD06C\uC544\uC774\uD15C\uC774 ${activeWorkitem ?? "(\uC5C6\uC74C)"}\uC73C\uB85C \uBC14\uB00C\uC5B4 \uC788\uC5B4 ${opts.workitem} \uB300\uC0C1 \uAC31\uC2E0\uC744 \uAC70\uBD80\uD588\uC2B5\uB2C8\uB2E4.
+`
+    );
+    process.exit(1);
+  }
   if (gateRejected) {
     process.stderr.write(
       "\n  \uAC8C\uC774\uD2B8 1 \uC2B9\uC778 \uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. awl record gate \uB85C \uACC4\uD68D\uC744 \uC2B9\uC778(approved)\uD55C \uB4A4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.\n"

package/dist/{chunk-IVEV5L7P.js → chunk-TCIRO4GU.js}

@@ -3,7 +3,7 @@ import {
   multiProjectFooter,
   requireConfig,
   resolveProjectScope
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   caps,
   generationsDir,

package/dist/{chunk-SSSOO2GH.js → chunk-UFVGXPJB.js}

@@ -5,18 +5,18 @@ import {
   runWorkNew,
   sanitizeForGit,
   worktreeDirtyTracked
-} from "./chunk-AGFQC2UO.js";
+} from "./chunk-JY3DXRXV.js";
 import {
   loadProjectName
-} from "./chunk-FK3Q7UY2.js";
+} from "./chunk-2NETKDCV.js";
 import {
   loadState,
   writeState
-} from "./chunk-VE2GVNNS.js";
+} from "./chunk-RTZLAXTZ.js";
 import {
   resolveProjectRoot,
   run
-} from "./chunk-MLTY3EE6.js";
+} from "./chunk-FLVRMRHX.js";
 import {
   WORKTREES_DIR,
   caps,