@uzysjung/agent-harness 26.88.1 → 26.89.0

package/templates/hooks/gate-check.sh

@@ -1,138 +0,0 @@
-#!/bin/bash
-# PreToolUse Hook: 워크플로우 게이트 강제
-# Skill 도구 호출 시 이전 게이트 완료 여부 확인
-# 미완료 시 exit code 2로 차단
-set -e
-
-GATE_FILE=".claude/gate-status.json"
-INPUT_JSON=$(cat)
-
-# tool_input에서 skill 이름 추출 (jq 우선, bash 폴백)
-if command -v jq &> /dev/null; then
-  SKILL_NAME=$(echo "$INPUT_JSON" | jq -r '.tool_input.skill // .tool_input.args // ""' 2>/dev/null || echo "")
-else
-  # jq 없을 때 bash 폴백
-  SKILL_NAME=$(echo "$INPUT_JSON" | grep -o '"skill"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*: *"//;s/"//')
-  if [ -z "$SKILL_NAME" ]; then
-    SKILL_NAME=$(echo "$INPUT_JSON" | grep -o '"args"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*: *"//;s/"//')
-  fi
-fi
-
-# uzys: 커맨드가 아니면 통과
-# uzys:auto는 게이트 체크 제외 (auto 커맨드가 내부에서 gate-status 직접 관리)
-case "$SKILL_NAME" in
-  uzys:spec|uzys:plan|uzys:build|uzys:test|uzys:review|uzys:ship) ;;
-  uzys:auto) exit 0 ;;
-  *) exit 0 ;;
-esac
-
-# gate-status.json 없으면 초기 상태 생성 (모두 미완료)
-if [ ! -f "$GATE_FILE" ]; then
-  mkdir -p "$(dirname "$GATE_FILE")"
-  cat > "$GATE_FILE" << 'INIT'
-{
-  "define": { "completed": false },
-  "plan": { "completed": false },
-  "build": { "completed": false },
-  "verify": { "completed": false },
-  "review": { "completed": false },
-  "ship": { "completed": false },
-  "hotfix": false
-}
-INIT
-fi
-
-# v26.11.2 — 게이트 상태 읽기. jq 실패/손상된 JSON 시 안전한 default "false"로 fail-secure.
-# (이전: jq 실패 시 빈 출력 가능 → 호출자에서 일관성 없는 처리. C2 수정)
-is_completed() {
-  local result=""
-  if command -v jq &> /dev/null; then
-    result=$(jq -r ".$1.completed // false" "$GATE_FILE" 2>/dev/null) || result="false"
-  else
-    grep -A1 "\"$1\"" "$GATE_FILE" 2>/dev/null | grep -o '"completed"[[:space:]]*:[[:space:]]*true' | head -1 | grep -q 'true' && result="true" || result="false"
-  fi
-  case "$result" in
-    true|false) echo "$result" ;;
-    *) echo "false" ;;
-  esac
-}
-
-is_hotfix() {
-  local result=""
-  if command -v jq &> /dev/null; then
-    result=$(jq -r ".hotfix // false" "$GATE_FILE" 2>/dev/null) || result="false"
-  else
-    grep -o '"hotfix"[[:space:]]*:[[:space:]]*true' "$GATE_FILE" 2>/dev/null | head -1 | grep -q 'true' && result="true" || result="false"
-  fi
-  case "$result" in
-    true|false) echo "$result" ;;
-    *) echo "false" ;;
-  esac
-}
-
-HOTFIX=$(is_hotfix)
-
-# 게이트 순서 검증
-case "$SKILL_NAME" in
-  uzys:spec)
-    # Define은 항상 허용 (첫 단계). 새 사이클 시작이므로 모든 게이트 리셋
-    cat > "$GATE_FILE" << 'RESET'
-{
-  "define": { "completed": false },
-  "plan": { "completed": false },
-  "build": { "completed": false },
-  "verify": { "completed": false },
-  "review": { "completed": false },
-  "ship": { "completed": false },
-  "hotfix": false
-}
-RESET
-    exit 0
-    ;;
-  uzys:plan)
-    if [ "$(is_completed define)" != "true" ]; then
-      echo "BLOCKED: Define 단계가 완료되지 않았습니다. /uzys:spec을 먼저 실행하세요. (docs/SPEC.md 필요)" >&2
-      exit 2
-    fi
-    ;;
-  uzys:build)
-    if [ "$HOTFIX" = "true" ]; then
-      exit 0  # hotfix 모드: plan 건너뛰기 허용
-    fi
-    if [ "$(is_completed plan)" != "true" ]; then
-      echo "BLOCKED: Plan 단계가 완료되지 않았습니다. /uzys:plan을 먼저 실행하세요. (docs/todo.md 필요)" >&2
-      exit 2
-    fi
-    ;;
-  uzys:test)
-    if [ "$(is_completed build)" != "true" ]; then
-      echo "BLOCKED: Build 단계가 완료되지 않았습니다. /uzys:build를 먼저 실행하세요." >&2
-      exit 2
-    fi
-    ;;
-  uzys:review)
-    if [ "$HOTFIX" = "true" ]; then
-      exit 0  # hotfix 모드: review 건너뛰기 허용
-    fi
-    if [ "$(is_completed verify)" != "true" ]; then
-      echo "BLOCKED: Verify 단계가 완료되지 않았습니다. /uzys:test를 먼저 실행하세요." >&2
-      exit 2
-    fi
-    ;;
-  uzys:ship)
-    if [ "$HOTFIX" = "true" ]; then
-      # hotfix: verify만 필수
-      if [ "$(is_completed verify)" != "true" ]; then
-        echo "BLOCKED: Hotfix 모드에서도 Verify는 필수입니다. /uzys:test를 먼저 실행하세요." >&2
-        exit 2
-      fi
-      exit 0
-    fi
-    if [ "$(is_completed review)" != "true" ]; then
-      echo "BLOCKED: Review 단계가 완료되지 않았습니다. /uzys:review를 먼저 실행하세요." >&2
-      exit 2
-    fi
-    ;;
-esac
-
-exit 0

package/templates/opencode/.opencode/commands/uzys-build.md

@@ -1,22 +0,0 @@
----
-description: "Build phase — TDD로 점진적 구현한다."
-agent: build
----
-
-# /uzys-build — OpenCode
-
-> **Generated from**: `.claude/commands/uzys/build.md` via TS CLI `src/opencode/skills.ts` (Phase C)
-> **Slash**: `/uzys-build` (OpenCode namespace 미사용 — Phase B2 결정, hyphen 채택)
-
-## Goal
-
-{COMMAND_BODY_PLACEHOLDER}
-
-## OpenCode 제약 참고
-
-- Slash 콜론 namespace 미사용 — 파일명 = 커맨드명 (`uzys-build.md` → `/uzys-build`)
-- Plugin lifecycle (`.opencode/plugins/uzys-harness.ts`)이 gate-check / spec-drift / HITO 처리
-
----
-
-*Phase C에서 본 command 본문이 `.claude/commands/uzys/build.md`로부터 포팅됨.*

package/templates/opencode/.opencode/commands/uzys-plan.md

@@ -1,22 +0,0 @@
----
-description: "Plan phase — 작업을 검증 가능한 작은 단위로 분해한다."
-agent: plan
----
-
-# /uzys-plan — OpenCode
-
-> **Generated from**: `.claude/commands/uzys/plan.md` via TS CLI `src/opencode/skills.ts` (Phase C)
-> **Slash**: `/uzys-plan` (OpenCode namespace 미사용 — Phase B2 결정, hyphen 채택)
-
-## Goal
-
-{COMMAND_BODY_PLACEHOLDER}
-
-## OpenCode 제약 참고
-
-- Slash 콜론 namespace 미사용 — 파일명 = 커맨드명 (`uzys-plan.md` → `/uzys-plan`)
-- Plugin lifecycle (`.opencode/plugins/uzys-harness.ts`)이 gate-check / spec-drift / HITO 처리
-
----
-
-*Phase C에서 본 command 본문이 `.claude/commands/uzys/plan.md`로부터 포팅됨.*

package/templates/opencode/.opencode/commands/uzys-review.md

@@ -1,22 +0,0 @@
----
-description: "Review phase — 다중 관점 리뷰로 품질을 검증한다."
-agent: plan
----
-
-# /uzys-review — OpenCode
-
-> **Generated from**: `.claude/commands/uzys/review.md` via TS CLI `src/opencode/skills.ts` (Phase C)
-> **Slash**: `/uzys-review` (OpenCode namespace 미사용 — Phase B2 결정, hyphen 채택)
-
-## Goal
-
-{COMMAND_BODY_PLACEHOLDER}
-
-## OpenCode 제약 참고
-
-- Slash 콜론 namespace 미사용 — 파일명 = 커맨드명 (`uzys-review.md` → `/uzys-review`)
-- Plugin lifecycle (`.opencode/plugins/uzys-harness.ts`)이 gate-check / spec-drift / HITO 처리
-
----
-
-*Phase C에서 본 command 본문이 `.claude/commands/uzys/review.md`로부터 포팅됨.*

package/templates/opencode/.opencode/commands/uzys-ship.md

@@ -1,22 +0,0 @@
----
-description: "Ship phase — 프리런치 체크리스트 실행 후 배포한다."
-agent: build
----
-
-# /uzys-ship — OpenCode
-
-> **Generated from**: `.claude/commands/uzys/ship.md` via TS CLI `src/opencode/skills.ts` (Phase C)
-> **Slash**: `/uzys-ship` (OpenCode namespace 미사용 — Phase B2 결정, hyphen 채택)
-
-## Goal
-
-{COMMAND_BODY_PLACEHOLDER}
-
-## OpenCode 제약 참고
-
-- Slash 콜론 namespace 미사용 — 파일명 = 커맨드명 (`uzys-ship.md` → `/uzys-ship`)
-- Plugin lifecycle (`.opencode/plugins/uzys-harness.ts`)이 gate-check / spec-drift / HITO 처리
-
----
-
-*Phase C에서 본 command 본문이 `.claude/commands/uzys/ship.md`로부터 포팅됨.*

package/templates/opencode/.opencode/commands/uzys-spec.md

@@ -1,28 +0,0 @@
----
-description: "Define phase — 구조화된 스펙을 코드 작성 전에 작성한다."
-agent: plan
----
-
-# /uzys-spec — Define Phase (OpenCode)
-
-> **Generated from**: `.claude/commands/uzys/spec.md` via TS CLI `src/opencode/skills.ts` (Phase C)
-> **Slash**: `/uzys-spec` (OpenCode namespace 미사용 — Phase B2 결정, hyphen 채택)
-
-## Pre-flight
-
-이 command 호출 전 확인:
-- 직전 단계 없음 (최초 진입점)
-- `docs/SPEC.md` 또는 `docs/specs/<feature>.md`가 아직 없거나 갱신 필요한 상황
-
-## Goal
-
-{COMMAND_BODY_PLACEHOLDER}
-
-## OpenCode 제약 참고
-
-- Slash 콜론 namespace 미사용 — 파일명 = 커맨드명 (`uzys-spec.md` → `/uzys-spec`)
-- Plugin lifecycle (`.opencode/plugins/uzys-harness.ts`)이 gate-check / spec-drift / HITO 처리
-
----
-
-*Phase C에서 본 command 본문이 `.claude/commands/uzys/spec.md`로부터 포팅됨.*

package/templates/opencode/.opencode/commands/uzys-test.md

@@ -1,22 +0,0 @@
----
-description: "Verify phase — TDD 워크플로우와 Track별 커버리지 게이트를 실행한다."
-agent: build
----
-
-# /uzys-test — OpenCode
-
-> **Generated from**: `.claude/commands/uzys/test.md` via TS CLI `src/opencode/skills.ts` (Phase C)
-> **Slash**: `/uzys-test` (OpenCode namespace 미사용 — Phase B2 결정, hyphen 채택)
-
-## Goal
-
-{COMMAND_BODY_PLACEHOLDER}
-
-## OpenCode 제약 참고
-
-- Slash 콜론 namespace 미사용 — 파일명 = 커맨드명 (`uzys-test.md` → `/uzys-test`)
-- Plugin lifecycle (`.opencode/plugins/uzys-harness.ts`)이 gate-check / spec-drift / HITO 처리
-
----
-
-*Phase C에서 본 command 본문이 `.claude/commands/uzys/test.md`로부터 포팅됨.*

package/templates/opencode/.opencode/plugins/uzys-harness.ts

@@ -1,146 +0,0 @@
-// uzys-harness — OpenCode plugin (Phase E1 본문)
-//
-// SPEC: docs/specs/opencode-compat.md AC5
-// ADR: docs/decisions/ADR-004-opencode-plugin-mapping.md
-//
-// Hook 매핑 (ADR-004 v1):
-//   - PreToolUse        → tool.execute.before (gate-check 등가)
-//   - PostToolUse       → tool.execute.after  (spec-drift-check 등가)
-//   - UserPromptSubmit  → messageCreated filter role==="user" (HITO 카운터)
-//
-// Reference: templates/hooks/{hito-counter,gate-check,spec-drift-check}.sh
-//
-// 본 파일은 사용자 프로젝트에 그대로 복사되는 self-contained template.
-// 핵심 로직은 src/opencode/plugin-helpers.ts에서도 동일하게 유지(테스트용 미러).
-//
-// Phase E2 실측 항목 (한계 L1~L4):
-//   L1 Plugin runtime (Bun vs Node) — OpenCode CLI 실측 필요
-//   L2 tool.execute.before 인자 정확한 시그니처
-//   L3 messageCreated user-only 필터 충분 여부
-//   L4 throw 시 graceful 차단/crash 동작
-
-import type { Plugin } from "@opencode-ai/plugin";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-
-type GateStatus = {
-  define?: { completed?: boolean };
-  plan?: { completed?: boolean };
-  build?: { completed?: boolean };
-  verify?: { completed?: boolean };
-  review?: { completed?: boolean };
-  ship?: { completed?: boolean };
-};
-
-type Phase = "define" | "plan" | "build" | "verify" | "review" | "ship";
-
-const PHASE_DEPENDENCY: Record<string, Phase | null> = {
-  "uzys-spec": null,
-  "uzys-plan": "define",
-  "uzys-build": "plan",
-  "uzys-test": "build",
-  "uzys-review": "verify",
-  "uzys-ship": "review",
-};
-
-const PHASE_TO_COMMAND: Record<Phase, string> = {
-  define: "spec",
-  plan: "plan",
-  build: "build",
-  verify: "test",
-  review: "review",
-  ship: "ship",
-};
-
-const SPEC_PATH_RE = /docs\/SPEC\.md$|docs\/specs\/[^/]+\.md$/;
-
-const UzysHarness: Plugin = async ({ directory }) => {
-  return {
-    "tool.execute.before": async (input, _output) => {
-      const command = extractSlashCommand(input);
-      if (!command) return;
-
-      const required = PHASE_DEPENDENCY[command];
-      if (required === undefined) return;
-      if (required === null) return;
-
-      const status = readGateStatus(directory);
-      if (status[required]?.completed !== true) {
-        throw new Error(
-          `[uzys-harness] /${command} requires ${required} gate completion. ` +
-            `Run /uzys-${PHASE_TO_COMMAND[required]} first.`,
-        );
-      }
-    },
-
-    "tool.execute.after": async (input, _output) => {
-      const filePath = extractFilePath(input);
-      if (!filePath || !SPEC_PATH_RE.test(filePath)) return;
-
-      const date = new Date().toISOString().slice(0, 10);
-      const logDir = join(directory, ".claude/evals");
-      try {
-        mkdirSync(logDir, { recursive: true });
-        const stamp = new Date().toISOString();
-        writeFileSync(join(logDir, `spec-drift-${date}.log`), `${stamp} edited ${filePath}\n`, {
-          flag: "a",
-        });
-      } catch {
-        // Best-effort logging — never block tool execution.
-      }
-    },
-
-    messageCreated: async (message, _output) => {
-      if (message.role !== "user") return;
-
-      const date = new Date().toISOString().slice(0, 10);
-      const logDir = join(directory, ".claude/evals");
-      try {
-        mkdirSync(logDir, { recursive: true });
-        const stamp = new Date().toISOString();
-        writeFileSync(join(logDir, `hito-${date}.log`), `${stamp} prompt_submit\n`, {
-          flag: "a",
-        });
-      } catch {
-        // Privacy: prompt body never logged. Best-effort.
-      }
-    },
-  };
-};
-
-export default UzysHarness;
-
-function readGateStatus(projectDir: string): GateStatus {
-  const path = join(projectDir, ".claude/gate-status.json");
-  if (!existsSync(path)) return {};
-  try {
-    return JSON.parse(readFileSync(path, "utf8")) as GateStatus;
-  } catch {
-    return {};
-  }
-}
-
-function extractSlashCommand(input: unknown): string | null {
-  if (!input || typeof input !== "object") return null;
-  const c = input as { command?: unknown; tool?: unknown; args?: { command?: unknown } };
-  if (typeof c.command === "string") return c.command.startsWith("/") ? c.command.slice(1) : c.command;
-  if (typeof c.tool === "string" && c.tool.startsWith("uzys-")) return c.tool;
-  if (c.args && typeof c.args === "object" && typeof c.args.command === "string") {
-    return c.args.command.startsWith("/") ? c.args.command.slice(1) : c.args.command;
-  }
-  return null;
-}
-
-function extractFilePath(input: unknown): string | null {
-  if (!input || typeof input !== "object") return null;
-  const c = input as {
-    filePath?: unknown;
-    args?: { filePath?: unknown; path?: unknown };
-  };
-  if (typeof c.filePath === "string") return c.filePath;
-  if (c.args && typeof c.args === "object") {
-    if (typeof c.args.filePath === "string") return c.args.filePath;
-    if (typeof c.args.path === "string") return c.args.path;
-  }
-  return null;
-}

package/templates/project-claude/fragments/csr-fastapi/workflow.md

@@ -1,8 +0,0 @@
-6-gate 개발 워크플로우 적용:
-
-```
-Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
-```
-
-- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
-- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).

package/templates/project-claude/fragments/csr-fastify/workflow.md

@@ -1,8 +0,0 @@
-6-gate 개발 워크플로우 적용:
-
-```
-Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
-```
-
-- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
-- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).

package/templates/project-claude/fragments/csr-supabase/workflow.md

@@ -1,8 +0,0 @@
-6-gate 개발 워크플로우 적용:
-
-```
-Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
-```
-
-- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
-- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).

package/templates/project-claude/fragments/data/workflow.md

@@ -1,9 +0,0 @@
-6-gate 개발 워크플로우 적용:
-
-```
-Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
-```
-
-- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
-- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).
-- 탐색적 분석(EDA)은 Build 게이트에서 노트북 기반 진행 허용.

package/templates/project-claude/fragments/ssr-htmx/workflow.md

@@ -1,8 +0,0 @@
-6-gate 개발 워크플로우 적용:
-
-```
-Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
-```
-
-- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
-- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).

package/templates/project-claude/fragments/ssr-nextjs/workflow.md

@@ -1,8 +0,0 @@
-6-gate 개발 워크플로우 적용:
-
-```
-Define(/uzys:spec) -> Plan(/uzys:plan) -> Build(/uzys:build) -> Verify(/uzys:test) -> Review(/uzys:review) -> Ship(/uzys:ship)
-```
-
-- 각 게이트를 순서대로 통과해야 다음 단계 진행 가능.
-- Hotfix 단축: Build -> Verify -> Ship (긴급 수정에 한함).

package/templates/project-claude/fragments/tooling/workflow.md

@@ -1,5 +0,0 @@
-```
-Define(/uzys:spec) → Plan(/uzys:plan) → Build(/uzys:build) → Verify(/uzys:test) → Review(/uzys:review) → Ship(/uzys:ship)
-```
-
-각 단계는 `.claude/hooks/gate-check.sh`로 강제. 이전 단계 미완료 시 다음 단계 실행 차단.