@sduck/sduck-cli 0.1.3 → 0.1.4

package/.sduck/sduck-assets/agent-rules/antigravity.md

@@ -2,3 +2,4 @@
 
 - Follow the repository SDD workflow exactly.
 - Use this workspace rule file together with the shared SDD workflow block.
+- 승인된 spec.md/plan.md를 수정하지 않는다. 요구사항이 바뀌면 새 태스크를 시작한다.

package/.sduck/sduck-assets/agent-rules/claude-code.md

@@ -10,6 +10,7 @@
 - **플랜 승인**은 사용자가 명시적으로 승인해야 한다
 
 승인 전에는 어떤 코드도 작성하지 않는다.
+승인된 spec.md/plan.md를 수정하지 않는다. 요구사항이 바뀌면 새 태스크를 시작한다.
 
 ## Claude Code Instructions
 

package/.sduck/sduck-assets/agent-rules/codex.md

@@ -10,6 +10,7 @@
 - **플랜 승인**은 사용자가 명시적으로 승인해야 한다
 
 승인 전에는 어떤 코드도 작성하지 않는다.
+승인된 spec.md/plan.md를 수정하지 않는다. 요구사항이 바뀌면 새 태스크를 시작한다.
 
 ## Codex Instructions
 

package/.sduck/sduck-assets/agent-rules/core.md

@@ -1,5 +1,20 @@
 # SDD Workflow Rules
 
+## ⚠️ CRITICAL: 상태별 파일 접근 제한
+
+- 코드를 작성하기 전에 반드시 `.sduck/sduck-workspace/`의 활성 태스크 `meta.yml`을 읽고 `status`를 확인한다.
+- `IN_PROGRESS` 상태에서만 구현 코드를 작성할 수 있다.
+- 승인된 `spec.md`/`plan.md`는 수정하지 않는다. 요구사항이 바뀌면 새 태스크를 시작한다.
+- `spec.md` 또는 `plan.md`를 작성한 직후라도, 사용자가 승인하기 전까지 구현하지 않는다.
+- "같은 세션"이라는 이유로 승인을 생략하지 않는다.
+
+| 상태 | spec.md | plan.md | 구현 파일 |
+|---|---|---|---|
+| PENDING_SPEC_APPROVAL | 허용 | 허용 | 차단 |
+| SPEC_APPROVED | 차단 | 허용 | 차단 |
+| IN_PROGRESS | 차단 | 차단 | 허용 |
+| DONE | 차단 | 차단 | 차단 |
+
 ## 디렉토리 구조
 
 에이전트는 아래 경로를 기준으로 `sduck` 상태를 읽고 쓴다.

package/.sduck/sduck-assets/agent-rules/cursor.mdc

@@ -9,3 +9,4 @@ alwaysApply: true
 
 - Follow the repository SDD workflow exactly.
 - Use this rule file together with the shared SDD workflow block.
+- 승인된 spec.md/plan.md를 수정하지 않는다. 요구사항이 바뀌면 새 태스크를 시작한다.

package/.sduck/sduck-assets/agent-rules/gemini-cli.md

@@ -10,6 +10,7 @@
 - **플랜 승인**은 사용자가 명시적으로 승인해야 한다
 
 승인 전에는 어떤 코드도 작성하지 않는다.
+승인된 spec.md/plan.md를 수정하지 않는다. 요구사항이 바뀌면 새 태스크를 시작한다.
 
 ## Gemini CLI Instructions
 

package/.sduck/sduck-assets/agent-rules/hooks/sdd-guard.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# sduck SDD guard hook for Claude Code
+# Enforces the state-based file access matrix via PreToolUse hook.
+# Exit 0 = allow, Exit 2 = block (message sent to Claude via stderr)
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+# No file path (e.g. Bash tool) → allow
+if [[ -z "$FILE_PATH" ]]; then
+  exit 0
+fi
+
+# Resolve relative to cwd
+CWD=$(echo "$INPUT" | jq -r '.cwd // empty')
+if [[ -z "$CWD" ]]; then
+  exit 0
+fi
+
+# Find sduck workspace
+WORKSPACE_DIR="$CWD/.sduck/sduck-workspace"
+if [[ ! -d "$WORKSPACE_DIR" ]]; then
+  exit 0
+fi
+
+# Always-allowed paths (relative check)
+REL_PATH="${FILE_PATH#"$CWD"/}"
+
+# Always allow: meta.yml, sduck assets, agent rule files, editor configs
+case "$REL_PATH" in
+  */meta.yml|.sduck/sduck-assets/*|.sduck/sduck-archive/*|\
+  CLAUDE.md|AGENT.md|GEMINI.md|\
+  .cursor/*|.agents/*|.claude/*|\
+  .serena/*)
+    exit 0
+    ;;
+esac
+
+# Find the most recent active task (non-DONE)
+STATUS=""
+TASK_DIR=""
+for dir in "$WORKSPACE_DIR"/*/; do
+  [[ -d "$dir" ]] || continue
+  META="$dir/meta.yml"
+  [[ -f "$META" ]] || continue
+
+  TASK_STATUS=$(grep -m1 '^status:' "$META" | sed 's/^status:[[:space:]]*//')
+
+  case "$TASK_STATUS" in
+    PENDING_SPEC_APPROVAL|SPEC_APPROVED|PENDING_PLAN_APPROVAL|IN_PROGRESS)
+      STATUS="$TASK_STATUS"
+      TASK_DIR="$dir"
+      ;;
+    DONE)
+      # Track DONE as fallback if no active task found
+      if [[ -z "$STATUS" ]]; then
+        STATUS="DONE"
+        TASK_DIR="$dir"
+      fi
+      ;;
+  esac
+done
+
+# No task at all → allow
+if [[ -z "$STATUS" ]]; then
+  exit 0
+fi
+
+# Check if the file is spec.md or plan.md (within the task workspace)
+IS_SPEC=false
+IS_PLAN=false
+case "$REL_PATH" in
+  */spec.md|spec.md) IS_SPEC=true ;;
+  */plan.md|plan.md) IS_PLAN=true ;;
+esac
+
+# Apply the state-based access matrix
+case "$STATUS" in
+  PENDING_SPEC_APPROVAL)
+    # spec.md, plan.md → allow; implementation files → block
+    if $IS_SPEC || $IS_PLAN; then
+      exit 0
+    fi
+    echo "⛔ [sduck] 현재 상태: $STATUS — 스펙 승인 전에는 구현 코드를 작성할 수 없습니다. \`sduck spec approve\`를 먼저 실행하세요." >&2
+    exit 2
+    ;;
+  SPEC_APPROVED|PENDING_PLAN_APPROVAL)
+    # plan.md → allow; spec.md, implementation files → block
+    if $IS_PLAN; then
+      exit 0
+    fi
+    if $IS_SPEC; then
+      echo "⛔ [sduck] 현재 상태: $STATUS — 승인된 스펙은 수정할 수 없습니다. 요구사항이 바뀌었다면 새 태스크를 시작하세요." >&2
+      exit 2
+    fi
+    echo "⛔ [sduck] 현재 상태: $STATUS — 플랜 승인 전에는 구현 코드를 작성할 수 없습니다. \`sduck plan approve\`를 먼저 실행하세요." >&2
+    exit 2
+    ;;
+  IN_PROGRESS)
+    # implementation files → allow; spec.md, plan.md → block
+    if $IS_SPEC; then
+      echo "⛔ [sduck] 현재 상태: IN_PROGRESS — 승인된 스펙은 수정할 수 없습니다. 요구사항이 바뀌었다면 새 태스크를 시작하세요." >&2
+      exit 2
+    fi
+    if $IS_PLAN; then
+      echo "⛔ [sduck] 현재 상태: IN_PROGRESS — 승인된 플랜은 수정할 수 없습니다. 요구사항이 바뀌었다면 새 태스크를 시작하세요." >&2
+      exit 2
+    fi
+    exit 0
+    ;;
+  DONE)
+    # everything blocked except always-allowed paths (already handled above)
+    if $IS_SPEC || $IS_PLAN; then
+      echo "⛔ [sduck] 현재 상태: DONE — 완료된 태스크의 문서는 수정할 수 없습니다. \`sduck start\`로 새 태스크를 시작하세요." >&2
+      exit 2
+    fi
+    echo "⛔ [sduck] 현재 상태: DONE — 새 코드를 작성하려면 \`sduck start\`로 새 태스크를 시작하세요." >&2
+    exit 2
+    ;;
+esac
+
+exit 0

package/.sduck/sduck-assets/agent-rules/opencode.md

@@ -10,6 +10,7 @@
 - **플랜 승인**은 사용자가 명시적으로 승인해야 한다
 
 승인 전에는 어떤 코드도 작성하지 않는다.
+승인된 spec.md/plan.md를 수정하지 않는다. 요구사항이 바뀌면 새 태스크를 시작한다.
 
 ## OpenCode Instructions
 

package/README.md

@@ -41,6 +41,46 @@ npm install -g @sduck/sduck-cli
 sduck init --agents claude-code,cursor,codex
 ```
 
+### Windows 환경에서 `sduck`을 찾지 못할 때
+
+Windows(PowerShell)에서 `npm install -g` 후 `sduck`을 실행했을 때 아래와 같은 에러가 발생할 수 있습니다.
+
+```
+sduck : 이 시스템에서 스크립트를 실행할 수 없습니다.
+# 또는
+sduck: The term 'sduck' is not recognized as the name of a cmdlet...
+```
+
+이는 npm 전역 설치 경로가 시스템 PATH에 포함되지 않아서 발생합니다.
+
+**1. npm 전역 경로 확인**
+
+```powershell
+npm config get prefix
+# 예: C:\Users\사용자이름\AppData\Roaming\npm
+```
+
+**2. PATH에 포함되어 있는지 확인**
+
+```powershell
+$env:PATH -split ';' | Select-String 'npm'
+```
+
+결과가 없으면 PATH에 추가해야 합니다.
+
+**3. PATH에 영구 추가 (PowerShell)**
+
+```powershell
+# 현재 사용자에게 영구 추가
+[Environment]::SetEnvironmentVariable(
+  'Path',
+  [Environment]::GetEnvironmentVariable('Path', 'User') + ';' + (npm config get prefix),
+  'User'
+)
+```
+
+설정 후 PowerShell을 재시작하면 `sduck` 명령어가 정상 동작합니다.
+
 ## 📖 주요 명령어
 
 ### 빠른 시작 예시