lee-spec-kit 0.6.21 → 0.6.22

package/README.en.md

@@ -301,7 +301,7 @@ Use `context --json` only when full-detail debugging fields are required.
 - `primaryActionLabel` / `primaryActionType` / `primaryActionCategory` / `primaryActionOperationType`: summary metadata for the first atomic action
 - `workflowPolicy`: current completion policy (`mode`, `requireIssue`, `requireBranch`, `requirePr`, `requireReview`)
 - `taskCommitGatePolicy`: task commit gate policy (`off` | `warn` | `strict`)
-- `prePrReviewPolicy`: pre-PR review policy (`enabled`, `skills`, `fallback`, `blockOnFindings`, `minorPolicy`)
+- `prePrReviewPolicy`: pre-PR review policy (`enabled`, `skills`, `fallback`)
 
 Error payloads (`status: "error"`) include `reasonCode` and labeled `suggestions` (`A/B/C`) (e.g. `INVALID_APPROVAL`, `CONTEXT_STALE`, `EXECUTION_FAILED`, `EXECUTION_NOT_COMMAND`).
 
@@ -351,6 +351,18 @@ npx lee-spec-kit flow
 # approve + execute (recommended agent path)
 npx lee-spec-kit flow F001 --approve A --execute
 
+# auto-run: stop and wait for approval when one of target categories appears
+npx lee-spec-kit flow F004 --auto-until-category pr_create,code_review,pr_status_update
+
+# auto-run using preset
+npx lee-spec-kit flow F004 --auto-preset pr-handoff
+
+# auto-run + apply new request first (runs user_request_replan first)
+npx lee-spec-kit flow F004 --request "promote issue 004 to F004 and proceed" --auto-until-category pr_create,code_review,pr_status_update
+
+# with default preset configured, request-only auto mode is available
+npx lee-spec-kit flow F004 --request "promote issue 004 to F004 and proceed"
+
 # JSON output for automation
 npx lee-spec-kit flow --json
 
@@ -366,11 +378,23 @@ npx lee-spec-kit flow --strict
 | `--component <id>`| Select target component in multi mode (e.g. `app`, `api`, `worker`) |
 | `--all`           | Include completed features when auto-detecting |
 | `--done`          | Show completed (workflow-done) features only |
+| `--request <text>` | In auto mode, apply a new user request first (auto-selects `user_request_replan`) |
+| `--auto-preset <name>` | Use a named auto preset (builtin: `pr-handoff`) |
+| `--auto-until-category <categories>` | Auto-execute command actions until one of target categories appears (comma-separated) |
 | `--approve <reply>` | Pass through context label approval (e.g. `A`, `A OK`, `A proceed`) |
 | `--execute`       | Execute approved option when it is a command (ticket is required only when `requiresUserCheck=true`) |
 | `--execute-strict`| With `--execute`, fail if approved option is instruction-only |
 | `--strict`        | Also run `status --strict` and `doctor --strict` |
 
+Auto gate mode rules:
+- `<feature-name>` is required with auto mode (`--auto-until-category` / `--auto-preset`) (for example `F004`).
+- Auto mode (`--auto-until-category` / `--auto-preset`) cannot be combined with `--approve` or `--execute`.
+- `--request` requires auto mode.
+  - Exception: if `workflow.auto.defaultPreset` is configured, `--request` alone enables auto mode.
+- Auto-run stops as `gate_reached` when a target category appears, then prints that step's approval text (`approvalRequest.userFacingLines`).
+- If progress stalls (same context/action repeating), it stops with `AUTO_NO_PROGRESS`.
+- In JSON mode, inspect `autoRun.status`, `autoRun.reasonCode`, `autoRun.gate`, and `autoRun.executions`.
+
 ### GitHub helpers
 
 ```bash
@@ -516,6 +540,10 @@ Running `init` creates `.lee-spec-kit.json` in your docs root (default: `docs/`)
 - `checkPolicy.acceptedTokens`: accepted reply templates (e.g. `["<LABEL>", "<LABEL> OK", "<LABEL> ...", "... <LABEL> ..."]`)
 - `checkPolicy.tokenPattern`: input validation regex for approval replies
 - `checkPolicy.validLabels`: currently selectable labels (`A`, `B`, `C`...)
+- `checkPolicy.activeCategories`: categories currently present in actions (from `actionOptions[].category`)
+- `checkPolicy.knownCategories`: full category list recognized by the CLI
+- `checkPolicy.uncategorizedLabels`: labels with missing category (should normally be empty)
+- `checkPolicy.categoryPolicyGuidance`: guidance for matching categories in `approval.mode="category"`
 - `checkPolicy.requireExplanationBeforeApproval`: require label-by-label explanation before asking approval
 - `checkPolicy.requiredExplanationFields`: fields to use for explanation (e.g. `actionOptions[].detail`)
 - `checkPolicy.contextVersion`: snapshot hash for stale-context validation
@@ -548,8 +576,11 @@ Running `init` creates `.lee-spec-kit.json` in your docs root (default: `docs/`)
   - `skills` (optional): preferred skill names in priority order (default: `["code-review-excellence"]`)
   - `fallback` (optional): baseline review policy (default: `"builtin-checklist"`)
     - Use the `Pre-PR Baseline Checklist` section in `docs get create-pr --json` as the single source of truth
-  - `blockOnFindings` (optional): require major findings to be resolved/aligned before PR creation (default: `true`)
-  - `minorPolicy` (optional): minor findings policy (`warn` | `block`, default: `warn`)
+- `workflow.auto`:
+  - `defaultPreset` (optional): default auto preset used by `flow --request "<text>"` (default: `"pr-handoff"`)
+  - `defaultUntilCategories` (optional): default gate categories (takes precedence over `defaultPreset`)
+  - `presets` (optional): custom preset map
+    - Example: `"my-handoff": ["pr_create", "code_review"]`
 
 Example:
 
@@ -559,11 +590,15 @@ Example:
     "mode": "github",
     "codeDirtyScope": "auto",
     "taskCommitGate": "warn",
+    "auto": {
+      "defaultPreset": "pr-handoff",
+      "presets": {
+        "my-handoff": ["pr_create", "code_review", "pr_status_update"]
+      }
+    },
     "prePrReview": {
       "skills": ["code-review-excellence"],
-      "fallback": "builtin-checklist",
-      "blockOnFindings": true,
-      "minorPolicy": "warn"
+      "fallback": "builtin-checklist"
     }
   }
 }
@@ -581,6 +616,9 @@ Example:
 - `requireCheckCategories` (`category` only): categories that **always** require CHECK (e.g. `["pr_create"]`, `["*"]`)
 - `skipCheckCategories` (`category` only): categories that **never** require CHECK (e.g. `["docs_commit"]`, `["*"]`)
 - `requireCheckSteps` (`steps` only): step numbers that require CHECK (e.g. `[3, 5, 12]`)
+- `taskExecuteCheck` (optional): `task_execute` approval policy (`both` | `start_only`, default: `both`)
+  - `both`: require approval for both TODO→DOING and DOING→DONE transitions
+  - `start_only`: require approval only for TODO→DOING, skip default approval for DOING→DONE
 
 #### category examples
 
@@ -600,7 +638,7 @@ Example:
 }
 ```
 
-> To discover available `category` values, check `actionOptions[].category` in `context --json-compact` first, and use `actions[].category` in `context --json` when needed.
+> Discover category values from `context --json`/`--json-compact` using `checkPolicy.activeCategories` (current), `checkPolicy.knownCategories` (full), and `actionOptions[].category` (per-label).
 
 ### pr (PR artifacts policy)
 

package/README.md

@@ -320,7 +320,7 @@ npx lee-spec-kit context F001 --approve A --execute --ticket <TICKET> --execute-
 - `primaryActionLabel`/`primaryActionType`/`primaryActionCategory`/`primaryActionOperationType`: 첫 번째 원자 액션 요약 메타데이터
 - `workflowPolicy`: 현재 완료 조건 정책 (`mode`, `requireIssue`, `requireBranch`, `requirePr`, `requireReview`)
 - `taskCommitGatePolicy`: 태스크 커밋 게이트 정책 (`off` | `warn` | `strict`)
-- `prePrReviewPolicy`: pre-PR 리뷰 정책 (`enabled`, `skills`, `fallback`, `blockOnFindings`, `minorPolicy`)
+- `prePrReviewPolicy`: pre-PR 리뷰 정책 (`enabled`, `skills`, `fallback`)
 
 오류 응답(`status: "error"`)에는 `reasonCode`와 `suggestions`(라벨형 다음 동작: `A/B/C`)가 포함됩니다. (예: `INVALID_APPROVAL`, `CONTEXT_STALE`, `EXECUTION_FAILED`, `EXECUTION_NOT_COMMAND`)
 
@@ -370,6 +370,18 @@ npx lee-spec-kit flow
 # 승인 + 실행 (에이전트 기본 실행 경로)
 npx lee-spec-kit flow F001 --approve A --execute
 
+# 자동 진행: 특정 category가 나오면 멈추고 사용자 승인 대기
+npx lee-spec-kit flow F004 --auto-until-category pr_create,code_review,pr_status_update
+
+# 자동 진행: preset 사용
+npx lee-spec-kit flow F004 --auto-preset pr-handoff
+
+# 자동 진행 + 새 요청 선반영(user_request_replan 우선 실행)
+npx lee-spec-kit flow F004 --request "issue 004를 F004로 승격시켜서 진행해" --auto-until-category pr_create,code_review,pr_status_update
+
+# 기본 preset 설정 시 더 짧게 실행 가능
+npx lee-spec-kit flow F004 --request "issue 004를 F004로 승격시켜서 진행해"
+
 # 에이전트 파이프라인용 JSON
 npx lee-spec-kit flow --json
 
@@ -385,11 +397,23 @@ npx lee-spec-kit flow --strict
 | `--component <id>` | multi에서 대상 컴포넌트 지정 (예: `app`, `api`, `worker`) |
 | `--all`            | 자동 감지 실패 시 완료된 Feature까지 포함해서 표시 |
 | `--done`           | 완료(workflow-done) Feature만 표시 |
+| `--request <text>` | auto 모드에서 새 사용자 요청을 먼저 반영 (`user_request_replan` 라벨 자동 선택) |
+| `--auto-preset <name>` | 이름 기반 auto preset 사용 (기본 제공: `pr-handoff`) |
+| `--auto-until-category <categories>` | command 액션을 자동 실행하다가 지정 category 중 하나가 나오면 중지 (쉼표 구분) |
 | `--approve <reply>`| context 라벨 승인 응답 전달 (예: `A`, `A OK`, `A 진행해`) |
 | `--execute`        | 승인한 옵션이 command일 때 실행 (`requiresUserCheck=true`면 티켓 연동, 아니면 티켓 없이 실행) |
 | `--execute-strict` | `--execute`와 함께 사용 시 instruction-only 옵션이면 실패 |
 | `--strict`         | `status --strict`, `doctor --strict`까지 함께 검사 |
 
+자동 게이트 모드 규칙:
+- auto 모드(`--auto-until-category`/`--auto-preset`) 사용 시 `<feature-name>`은 필수입니다. (예: `F004`)
+- auto 모드(`--auto-until-category`/`--auto-preset`)는 `--approve`, `--execute`와 함께 사용할 수 없습니다.
+- `--request`는 auto 모드와 함께 사용해야 합니다.
+  - 예외적으로 `workflow.auto.defaultPreset`이 설정되어 있으면 `--request`만으로도 auto 모드가 활성화됩니다.
+- 자동 진행은 지정한 category가 등장하면 `gate_reached`로 멈추고, 해당 단계의 승인 문구(`approvalRequest.userFacingLines`)를 그대로 출력합니다.
+- 진행 정체(동일 context/action 반복)가 감지되면 `AUTO_NO_PROGRESS`로 중단됩니다.
+- JSON 모드에서는 `autoRun.status`, `autoRun.reasonCode`, `autoRun.gate`, `autoRun.executions`로 상세 상태를 확인할 수 있습니다.
+
 ### GitHub helper
 
 ```bash
@@ -567,6 +591,10 @@ npx lee-spec-kit update --force
 - `checkPolicy.acceptedTokens`: 허용되는 승인 응답 템플릿 (예: `["<LABEL>", "<LABEL> OK", "<LABEL> ...", "... <LABEL> ..."]`)
 - `checkPolicy.tokenPattern`: 승인 응답 검증용 정규식
 - `checkPolicy.validLabels`: 현재 선택 가능한 라벨 목록 (`A`, `B`, `C`...)
+- `checkPolicy.activeCategories`: 현재 액션에 실제 등장한 category 목록 (`actionOptions[].category` 기준)
+- `checkPolicy.knownCategories`: CLI가 인식하는 전체 category 목록
+- `checkPolicy.uncategorizedLabels`: category가 비어 있는 라벨 목록 (정상이라면 빈 배열)
+- `checkPolicy.categoryPolicyGuidance`: `approval.mode="category"` 사용 시 category 매칭 기준 안내
 - `checkPolicy.requireExplanationBeforeApproval`: 승인 요청 전에 라벨별 설명을 포함해야 함
 - `checkPolicy.requiredExplanationFields`: 라벨 설명에 사용할 필드 목록 (예: `actionOptions[].detail`)
 - `checkPolicy.contextVersion`: stale context 검증용 스냅샷 해시
@@ -596,8 +624,11 @@ npx lee-spec-kit update --force
   - `skills` (선택): 우선순위 스킬 목록 (기본: `["code-review-excellence"]`)
   - `fallback` (선택): 기본 베이스라인 정책 (기본: `"builtin-checklist"`)
     - 상세 기준은 `docs get create-pr --json`의 `Pre-PR 기본 체크리스트` 섹션을 단일 기준으로 사용
-  - `blockOnFindings` (선택): 주요 이슈 발견 시 PR 생성 전 해결/합의를 요구할지 여부 (기본: `true`)
-  - `minorPolicy` (선택): minor 이슈 정책 (`warn` | `block`, 기본: `warn`)
+- `workflow.auto`:
+  - `defaultPreset` (선택): `flow --request "<요청>"` 실행 시 기본으로 사용할 auto preset 이름 (기본: `"pr-handoff"`)
+  - `defaultUntilCategories` (선택): 기본 gate category 목록 (설정 시 `defaultPreset`보다 우선)
+  - `presets` (선택): 사용자 정의 preset 맵
+    - 예: `"my-handoff": ["pr_create", "code_review"]`
 
 예시:
 
@@ -607,11 +638,15 @@ npx lee-spec-kit update --force
     "mode": "github",
     "codeDirtyScope": "auto",
     "taskCommitGate": "warn",
+    "auto": {
+      "defaultPreset": "pr-handoff",
+      "presets": {
+        "my-handoff": ["pr_create", "code_review", "pr_status_update"]
+      }
+    },
     "prePrReview": {
       "skills": ["code-review-excellence"],
-      "fallback": "builtin-checklist",
-      "blockOnFindings": true,
-      "minorPolicy": "warn"
+      "fallback": "builtin-checklist"
     }
   }
 }
@@ -629,6 +664,9 @@ npx lee-spec-kit update --force
 - `requireCheckCategories` (`category`만): 확인을 **항상** 요구할 category 목록 (예: `["pr_create"]`, `["*"]`)
 - `skipCheckCategories` (`category`만): 확인을 **절대** 요구하지 않을 category 목록 (예: `["docs_commit"]`, `["*"]`)
 - `requireCheckSteps` (`steps`만): 확인이 필요한 step 번호 목록 (예: `[3, 5, 12]`)
+- `taskExecuteCheck` (선택): `task_execute` 확인 정책 (`both` | `start_only`, 기본: `both`)
+  - `both`: TODO→DOING, DOING→DONE 모두 승인 필요
+  - `start_only`: TODO→DOING만 승인 필요, DOING→DONE은 기본 승인 생략
 
 #### category 예시
 
@@ -648,7 +686,7 @@ npx lee-spec-kit update --force
 }
 ```
 
-> 사용 가능한 `category` 값은 `context --json-compact`의 `actionOptions[].category`에서 우선 확인하고, 필요 시 `context --json`의 `actions[].category`를 참고하세요.
+> 사용 가능한 `category` 값은 `context --json`/`--json-compact`의 `checkPolicy.activeCategories`(현재), `checkPolicy.knownCategories`(전체), `actionOptions[].category`(라벨별)에서 확인하세요.
 
 ### pr (PR 결과물 정책)