@uzysjung/agent-harness 26.146.0 → 26.147.0

package/templates/commands/ecc/harness-audit.md

@@ -1,73 +0,0 @@
-# Harness Audit Command
-
-Run a deterministic repository harness audit and return a prioritized scorecard.
-
-## Usage
-
-`/harness-audit [scope] [--format text|json] [--root path]`
-
-- `scope` (optional): `repo` (default), `hooks`, `skills`, `commands`, `agents`
-- `--format`: output style (`text` default, `json` for automation)
-- `--root`: audit a specific path instead of the current working directory
-
-## Deterministic Engine
-
-Always run:
-
-```bash
-node scripts/harness-audit.js <scope> --format <text|json> [--root <path>]
-```
-
-This script is the source of truth for scoring and checks. Do not invent additional dimensions or ad-hoc points.
-
-Rubric version: `2026-03-30`.
-
-The script computes 7 fixed categories (`0-10` normalized each):
-
-1. Tool Coverage
-2. Context Efficiency
-3. Quality Gates
-4. Memory Persistence
-5. Eval Coverage
-6. Security Guardrails
-7. Cost Efficiency
-
-Scores are derived from explicit file/rule checks and are reproducible for the same commit.
-The script audits the current working directory by default and auto-detects whether the target is the ECC repo itself or a consumer project using ECC.
-
-## Output Contract
-
-Return:
-
-1. `overall_score` out of `max_score` (70 for `repo`; smaller for scoped audits)
-2. Category scores and concrete findings
-3. Failed checks with exact file paths
-4. Top 3 actions from the deterministic output (`top_actions`)
-5. Suggested ECC skills to apply next
-
-## Checklist
-
-- Use script output directly; do not rescore manually.
-- If `--format json` is requested, return the script JSON unchanged.
-- If text is requested, summarize failing checks and top actions.
-- Include exact file paths from `checks[]` and `top_actions[]`.
-
-## Example Result
-
-```text
-Harness Audit (repo): 66/70
-- Tool Coverage: 10/10 (10/10 pts)
-- Context Efficiency: 9/10 (9/10 pts)
-- Quality Gates: 10/10 (10/10 pts)
-
-Top 3 Actions:
-1) [Security Guardrails] Add prompt/tool preflight security guards in hooks/hooks.json. (hooks/hooks.json)
-2) [Tool Coverage] Sync commands/harness-audit.md and .opencode/commands/harness-audit.md. (.opencode/commands/harness-audit.md)
-3) [Eval Coverage] Increase automated test coverage across scripts/hooks/lib. (tests/)
-```
-
-## Arguments
-
-$ARGUMENTS:
-- `repo|hooks|skills|commands|agents` (optional scope)
-- `--format text|json` (optional output format)

package/templates/commands/ecc/instinct-status.md

@@ -1,8 +0,0 @@
-CL-v2에서 학습된 모든 instinct를 표시한다 (프로젝트 스코프 + 글로벌).
-
-```bash
-python3 .claude/skills/continuous-learning-v2/scripts/instinct-cli.py status
-```
-
-각 instinct는 신뢰도 점수(0.3-0.9)와 함께 표시. 도메인별로 그룹화.
-high-confidence instinct(≥0.8)는 Rule 승격 후보로 표시된다.

package/templates/commands/ecc/promote.md

@@ -1,10 +0,0 @@
-프로젝트 스코프 instinct를 글로벌 스코프로 승격시킨다.
-
-```bash
-python3 .claude/skills/continuous-learning-v2/scripts/instinct-cli.py promote [id]
-```
-
-id 없이 실행하면 승격 후보(confidence ≥ 0.8, 2개+ 프로젝트에서 확인)를 목록 표시.
-id를 지정하면 해당 instinct를 글로벌로 승격.
-
-글로벌 instinct는 모든 프로젝트에서 활성화된다.

package/templates/commands/ecc/security-scan.md

@@ -1,10 +0,0 @@
-Claude Code 설정(.claude/ 디렉토리)에 대한 AgentShield 보안 스캔을 실행한다.
-
-`npx ecc-agentshield scan` 을 실행하여 CLAUDE.md, settings.json, MCP 서버, hooks, agent 정의에서 보안 취약점, 설정 오류, 인젝션 위험을 검사한다.
-
-옵션:
-- `--fix`: 자동 수정 가능한 항목 수정 (하드코딩 시크릿 → 환경변수 참조 등)
-- `--min-severity medium`: 최소 심각도 필터
-- `--format json|markdown|html`: 출력 형식
-
-결과는 A-F 등급으로 표시. CRITICAL/HIGH 발견 시 즉시 조치 필요.

package/templates/hooks/mcp-pre-exec.sh

@@ -1,122 +0,0 @@
-#!/bin/bash
-# ============================================================
-# mcp-pre-exec.sh — PreToolUse hook (mcp__.* matcher)
-#
-# 목적: MCP tool 호출을 화이트리스트 + 위험 패턴으로 차단.
-#       CVE-2025-59536, CVE-2026-21852 (hooks/MCP RCE) 대응.
-#
-# 호출: templates/settings.json의 PreToolUse 매처 "mcp__.*" 에서 실행.
-# 입력: stdin JSON (tool_name, tool_input, cwd, session_id, ...)
-# 출력: stderr 경고 + exit 2 차단 또는 exit 0 통과
-#
-# 화이트리스트: $CLAUDE_PROJECT_DIR/.mcp-allowlist
-#   - 한 줄에 하나의 서버 이름 (예: context7, github, chrome-devtools)
-#   - '#' 주석, 빈 줄 허용
-#   - 파일 없으면 모든 MCP 호출 통과 (opt-in 구조 — 사용자가 의도적으로 활성)
-#
-# 위험 파라미터 패턴: stdin의 tool_input에 다음 패턴 감지 시 차단
-#   - rm -rf, curl | sh, wget | bash, eval, base64 decode + exec
-#
-# Exit codes:
-#   0: 통과 (MCP 아님, 화이트리스트 매칭, 또는 allowlist 없음)
-#   2: 차단 (서버 비매칭 또는 위험 패턴 감지)
-#
-# 차단 로그: $CLAUDE_PROJECT_DIR/.uzys-agent-harness/hook-blocks.log — 차단 시에만 1줄.
-# ============================================================
-set -u
-
-PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-ALLOWLIST="$PROJECT_DIR/.mcp-allowlist"
-
-# 차단 계측 — 차단 경로에서만 1줄 append. 통과를 기록하면 로그가 차단 계측으로 못 쓰인다.
-# 실패 허용은 이 함수 안에서만 선언한다 (cli-development.md §set 플래그): 로그를 못 쓰는
-# 상태여도 차단 판정은 그대로여야 한다 — 계측이 방어를 깨면 안 된다. stderr 를 버리는 것은
-# 이 훅의 stderr 가 사용자에게 보이는 차단 사유이기 때문이다.
-log_block() {
-  local dir="$PROJECT_DIR/.uzys-agent-harness"
-  {
-    mkdir -p "$dir" &&
-      printf '%s\tmcp-pre-exec\t%s\n' \
-        "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$(printf '%s' "$1" | tr '\n\r' '  ')" \
-        >>"$dir/hook-blocks.log"
-  } 2>/dev/null || return 0
-}
-
-# stdin JSON 파싱
-INPUT=$(cat 2>/dev/null || echo "{}")
-
-TOOL_NAME=""
-if command -v jq &>/dev/null; then
-  TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null || echo "")
-else
-  # jq 없을 때 bash 폴백
-  TOOL_NAME=$(echo "$INPUT" | grep -oE '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' | sed -E 's/.*"([^"]*)"$/\1/')
-fi
-
-# MCP tool 이 아니면 즉시 통과
-case "$TOOL_NAME" in
-  mcp__*__*) ;;
-  *) exit 0 ;;
-esac
-
-# 서버 이름 추출: mcp__<server>__<tool> → <server>
-SERVER_NAME=$(echo "$TOOL_NAME" | awk -F'__' '{print $2}')
-
-if [ -z "$SERVER_NAME" ]; then
-  echo "[mcp-pre-exec] WARN: cannot extract server name from '$TOOL_NAME'" >&2
-  exit 0
-fi
-
-# 화이트리스트 대조 (파일 없으면 opt-in 미활성 — 통과)
-if [ ! -f "$ALLOWLIST" ]; then
-  exit 0
-fi
-
-# 화이트리스트에 서버 있는지 확인 (주석/빈 줄 제외)
-MATCHED=false
-while IFS= read -r line; do
-  # 주석과 빈 줄 skip
-  case "$line" in
-    ""|"#"*) continue ;;
-  esac
-  # trim whitespace
-  clean=$(echo "$line" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-  if [ "$clean" = "$SERVER_NAME" ]; then
-    MATCHED=true
-    break
-  fi
-done < "$ALLOWLIST"
-
-if [ "$MATCHED" = false ]; then
-  log_block "$TOOL_NAME (server not in allowlist)"
-  echo "[mcp-pre-exec] BLOCKED: MCP server '$SERVER_NAME' not in allowlist" >&2
-  echo "" >&2
-  echo "Tool: $TOOL_NAME" >&2
-  echo "Allowlist: $ALLOWLIST" >&2
-  echo "" >&2
-  echo "이 서버를 허용하려면 '$SERVER_NAME'을 $ALLOWLIST 에 한 줄로 추가." >&2
-  exit 2
-fi
-
-# 위험 파라미터 패턴 검사 (tool_input 전체를 문자열로)
-TOOL_INPUT_JSON=""
-if command -v jq &>/dev/null; then
-  TOOL_INPUT_JSON=$(echo "$INPUT" | jq -r '.tool_input // empty' 2>/dev/null || echo "")
-else
-  TOOL_INPUT_JSON=$(echo "$INPUT" | grep -oE '"tool_input"[[:space:]]*:[[:space:]]*\{[^}]*\}')
-fi
-
-if [ -n "$TOOL_INPUT_JSON" ]; then
-  if echo "$TOOL_INPUT_JSON" | grep -qE "rm -rf|curl[^|]*\| *sh|wget[^|]*\| *bash|\beval\b.*\\\$|base64[[:space:]]+-d.*\| *sh"; then
-    log_block "$TOOL_NAME (suspicious tool_input pattern)"
-    echo "[mcp-pre-exec] BLOCKED: suspicious parameter pattern in tool_input" >&2
-    echo "" >&2
-    echo "Tool: $TOOL_NAME" >&2
-    echo "위험 패턴 감지: rm -rf / curl|sh / wget|bash / eval \$... / base64-d|sh" >&2
-    echo "" >&2
-    echo "의도된 사용이면 .mcp-allowlist 대신 이 서버의 다른 호출 경로 검토 필요." >&2
-    exit 2
-  fi
-fi
-
-exit 0

package/templates/mcp-allowlist.example

@@ -1,24 +0,0 @@
-# MCP Server Allowlist — opt-in security gate
-#
-# mcp-pre-exec.sh hook이 이 파일을 참조해 MCP 서버 호출을 화이트리스트
-# 방식으로 차단한다. 파일이 없으면 opt-in 미활성 (모든 MCP 호출 통과).
-#
-# 사용법:
-#   1. 이 파일을 프로젝트 루트에 `.mcp-allowlist` 이름으로 복사
-#   2. 허용할 MCP 서버 이름을 한 줄에 하나씩 작성
-#   3. '#' 주석과 빈 줄 허용
-#
-# 서버 이름 확인 방법:
-#   - .mcp.json의 `mcpServers` 필드 키 이름
-#   - 또는 PreToolUse에서 tool_name `mcp__<server>__<tool>` 의 <server>
-#
-# 기본 프로젝트 서버 (templates/mcp.json):
-context7
-github
-chrome-devtools
-
-# Track별 추가 서버 예시 (주석 해제 후 사용):
-# supabase          # csr-supabase Track
-# railway           # 배포 Track
-# notion            # executive Track
-# playwright        # UI Track

package/templates/rules/playwright-launch.md

@@ -1,16 +0,0 @@
-# Playwright Launch
-
-브라우저를 띄워 **사용자가 직접 쓰는** 모든 상황(E2E 수동 확인, UX 비교, fidelity audit, OAuth 로그인)에 적용. 여기 남긴 것은 **위반을 막는 금지문뿐**이다 — 절차·스크립트 골격·사용 패턴은 `ui-visual-review` 스킬이 SSOT. 금지문만 상주하는 이유는 위반이 **작업을 시작한 뒤에** 일어나서, 스킬 발화를 기다리면 이미 늦기 때문이다.
-
-## 절대 금지
-
-- **사용자 활성 Chrome 에 attach** (`mcp__chrome-devtools__*`) — 입력 latency.
-- **일회성 browser context** (Playwright MCP, `browser.newContext()`) — 영속 profile dir 이 없어 cookie/IndexedDB/SW 가 휘발한다. 매 launch 재로그인 + 버벅임.
-- **사용자가 키를 입력하는 동안 자동화 process 동시 실행** (CDP latency).
-- **reference SaaS(Linear/Notion/Jira 등) 측 `page.goto()`·`page.reload()`** — sidebar click only.
-
-## 필수 · 위반 시
-
-영속 profile dir + Chrome for Testing 별도 binary. 사용자 입력 구간에는 자동화 layer 0 — capture 는 입력이 끝난 뒤 별도 process 에서. 구현 형태는 `ui-visual-review` 스킬 참조.
-
-일회성 context 나 devtools attach 를 발견하면 즉시 닫고 영속 profile launcher 로 재기동한다. 사용자가 "버벅인다"고 하면 본 rule 위반 확인이 1순위다.