@yuaone/core 0.3.3 → 0.4.0

package/plugins/react/validators/rules.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://yuaone.com/schemas/validators.json",
+  "name": "React Validation Rules",
+  "version": "1.0.0",
+  "description": "Post-edit and quality validation rules for React code",
+  "validators": [
+    {
+      "id": "react-build-check",
+      "stage": "post",
+      "name": "React Build Verification",
+      "check": "pnpm build || next build || react-scripts build",
+      "severity": "error"
+    },
+    {
+      "id": "react-typecheck",
+      "stage": "post",
+      "name": "TypeScript Type Check",
+      "check": "tsc --noEmit",
+      "severity": "error"
+    },
+    {
+      "id": "react-lint-hooks",
+      "stage": "post",
+      "name": "React Hooks Lint",
+      "check": "eslint --rule 'react-hooks/rules-of-hooks: error' --rule 'react-hooks/exhaustive-deps: warn'",
+      "severity": "error"
+    },
+    {
+      "id": "react-test-pass",
+      "stage": "post",
+      "name": "Test Suite Pass",
+      "check": "pnpm test --passWithNoTests || vitest run || jest --passWithNoTests",
+      "severity": "warning"
+    },
+    {
+      "id": "no-prop-drilling-deep",
+      "stage": "quality",
+      "name": "No Deep Prop Drilling",
+      "check": "grep -rn '...props' --include='*.tsx' --include='*.jsx' | awk -F: '{print $1}' | sort | uniq -c | sort -rn | awk '$1 > 3 {print \"WARN: Deep prop drilling in \" $2 \" (\" $1 \" levels)\"}' ",
+      "severity": "warning"
+    },
+    {
+      "id": "no-use-effect-in-render",
+      "stage": "quality",
+      "name": "No Side Effects in Render Body",
+      "check": "grep -rn 'fetch\\|axios\\|XMLHttpRequest' --include='*.tsx' --include='*.jsx' | grep -v 'useEffect\\|useCallback\\|useMemo\\|import\\|require\\|//\\|\\*'",
+      "severity": "warning"
+    },
+    {
+      "id": "no-any-types",
+      "stage": "quality",
+      "name": "No Untyped Any",
+      "check": "grep -rn ': any\\b\\|as any\\b' --include='*.ts' --include='*.tsx' | grep -v 'node_modules\\|.d.ts\\|// eslint-disable'",
+      "severity": "warning"
+    },
+    {
+      "id": "no-dangerous-inner-html-unsanitized",
+      "stage": "safety",
+      "name": "No Unsanitized dangerouslySetInnerHTML",
+      "check": "grep -rn 'dangerouslySetInnerHTML' --include='*.tsx' --include='*.jsx' | grep -v 'DOMPurify\\|sanitize\\|purify\\|xss'",
+      "severity": "critical"
+    },
+    {
+      "id": "no-eval-usage",
+      "stage": "safety",
+      "name": "No eval() or new Function()",
+      "check": "grep -rn 'eval(\\|new Function(' --include='*.ts' --include='*.tsx' --include='*.js' --include='*.jsx' | grep -v 'node_modules\\|.d.ts'",
+      "severity": "critical"
+    },
+    {
+      "id": "no-exposed-secrets",
+      "stage": "safety",
+      "name": "No Exposed Secrets in Client Code",
+      "check": "grep -rn 'NEXT_PUBLIC_.*SECRET\\|NEXT_PUBLIC_.*KEY.*=\\|process\\.env\\.' --include='*.tsx' --include='*.jsx' | grep -v 'NEXT_PUBLIC_\\|node_modules'",
+      "severity": "critical"
+    },
+    {
+      "id": "accessible-interactive-elements",
+      "stage": "quality",
+      "name": "Interactive Elements Have Accessible Names",
+      "check": "grep -rn '<button\\|<a \\|role=\"button\"' --include='*.tsx' --include='*.jsx' | grep -v 'aria-label\\|aria-labelledby\\|>.*</'",
+      "severity": "warning"
+    },
+    {
+      "id": "no-index-key",
+      "stage": "quality",
+      "name": "No Array Index as Key",
+      "check": "grep -rn 'key={.*index\\|}' --include='*.tsx' --include='*.jsx' | grep -v 'node_modules'",
+      "severity": "warning"
+    }
+  ]
+}

package/plugins/typescript/patterns/best-practices.json

@@ -0,0 +1,25 @@
+{
+  "patterns": [
+    {
+      "id": "prefer-const",
+      "name": "Prefer Const",
+      "detect": "let\\s+\\w+\\s*=",
+      "action": "suggest",
+      "template": "Use `const` unless reassigned"
+    },
+    {
+      "id": "explicit-return-type",
+      "name": "Explicit Return Type",
+      "detect": "export\\s+(async\\s+)?function\\s+\\w+\\([^)]*\\)\\s*\\{",
+      "action": "suggest",
+      "template": "Add explicit return type annotation for exported functions"
+    },
+    {
+      "id": "avoid-any",
+      "name": "Avoid Any Type",
+      "detect": ":\\s*any\\b",
+      "action": "warn",
+      "template": "Replace `any` with a specific type or `unknown`"
+    }
+  ]
+}

package/plugins/typescript/patterns/common-errors.json

@@ -0,0 +1,32 @@
+{
+  "patterns": [
+    {
+      "id": "implicit-any",
+      "name": "Implicit Any Parameter",
+      "detect": "Parameter '\\w+' implicitly has an 'any' type",
+      "action": "auto-fix",
+      "template": "Add explicit type annotation: `{param}: {suggestedType}`"
+    },
+    {
+      "id": "null-assignment",
+      "name": "Null Assignment",
+      "detect": "Type 'null' is not assignable",
+      "action": "auto-fix",
+      "template": "Use optional type: `{type} | null` or `{type} | undefined`"
+    },
+    {
+      "id": "missing-property",
+      "name": "Missing Object Property",
+      "detect": "Property '\\w+' does not exist on type",
+      "action": "suggest",
+      "template": "Extend interface or use type assertion"
+    },
+    {
+      "id": "module-not-found",
+      "name": "Module Not Found",
+      "detect": "Cannot find module '.*'",
+      "action": "auto-fix",
+      "template": "Install missing dependency: `pnpm add {module}` or `pnpm add -D @types/{module}`"
+    }
+  ]
+}

package/plugins/typescript/plugin.yaml

@@ -0,0 +1,74 @@
+name: "@yuaone/plugin-typescript"
+version: "1.0.0"
+description: "TypeScript 전문 에이전트 스킬팩 — 타입 에러 해결, strict 모드 마이그레이션, 리팩토링"
+author: "yuaone"
+license: "MIT"
+yuan_version: ">=0.1.0"
+
+detect:
+  files:
+    - "tsconfig.json"
+  dependencies:
+    - "typescript"
+
+type: "hybrid"
+trustLevel: "official"
+category: "coding"
+
+skills:
+  - id: "ts-strict"
+    name: "TypeScript Strict Mode"
+    description: "strict 모드 활성화 + 기존 코드 마이그레이션"
+    trigger:
+      kind: "command"
+      command: "/skill ts-strict"
+
+  - id: "ts-migrate"
+    name: "JS → TS Migration"
+    description: "JavaScript 프로젝트를 TypeScript로 점진적 마이그레이션"
+    trigger:
+      kind: "command"
+      command: "/skill ts-migrate"
+
+  - id: "ts-refactor"
+    name: "Type-Safe Refactoring"
+    description: "타입 안전성을 보장하면서 리팩토링"
+    trigger:
+      kind: "file_pattern"
+      pattern: "*.ts"
+
+  - id: "ts-debug"
+    name: "TypeScript Error Debug"
+    description: "TS 컴파일 에러 자동 진단 + 수정"
+    trigger:
+      kind: "auto"
+      confidence: 0.8
+
+triggers:
+  - id: "ts-compile-error"
+    errorPattern: "TS\\d{4}:"
+    skillId: "ts-debug"
+    priority: 90
+  - id: "ts-type-mismatch"
+    errorPattern: "Type '.*' is not assignable to type"
+    skillId: "ts-debug"
+    priority: 85
+
+tools:
+  - name: "tsc-check"
+    description: "TypeScript 컴파일 체크 (tsc --noEmit)"
+    inputSchema:
+      type: "object"
+      properties:
+        project:
+          type: "string"
+          description: "tsconfig.json 경로"
+    requiresApproval: false
+    riskLevel: "low"
+
+permissions:
+  fileRead: true
+  fileWrite: true
+  shellExec: true
+  networkAccess: false
+  gitOps: false

package/plugins/typescript/skills/debug.md

@@ -0,0 +1,23 @@
+## Identity
+TypeScript 컴파일 에러 진단 전문가. TS 에러 코드(TS2xxx)를 해석하고 최적 수정안을 제시.
+
+## Known Error Patterns
+- `TS2304: Cannot find name` → import 누락, 타입 정의 설치 필요 (@types/xxx)
+- `TS2339: Property does not exist on type` → 타입 단언, 옵셔널 체이닝, 인터페이스 확장
+- `TS2322: Type not assignable` → 타입 좁히기 (narrowing), type guard, as const
+- `TS2345: Argument type mismatch` → 오버로드, 제네릭, 유니온 타입
+- `TS2769: No overload matches` → 함수 시그니처 확인, 타입 파라미터 명시
+- `TS1005: expected` → 구문 에러, 세미콜론/괄호 누락
+- `TS18046: is of type unknown` → type guard 또는 as assertion
+
+## Tool Sequence
+1. `shell_exec` — `tsc --noEmit 2>&1` 로 전체 에러 수집
+2. `grep` — 에러 코드별 분류 (TS2322, TS2339 등)
+3. `file_read` — 에러 발생 파일 + 관련 타입 정의 확인
+4. `file_edit` — 에러 수정 (가장 빈도 높은 것부터)
+5. `shell_exec` — 수정 후 재검증
+
+## Validation Checklist
+- [ ] tsc --noEmit 에러 0개
+- [ ] 새로운 @ts-ignore 없음
+- [ ] 기존 타입 안전성 유지 (any 추가 없음)

package/plugins/typescript/skills/migration.md

@@ -0,0 +1,24 @@
+## Identity
+JavaScript → TypeScript 마이그레이션 전문가. 점진적 변환 전략으로 기존 JS 프로젝트를 TS로 안전하게 전환.
+
+## Known Error Patterns
+- `.js` 파일에서 import 실패 → allowJs: true, declaration: true 설정
+- `require()` 사용 → ES module import로 변환
+- `module.exports` → export default/named export
+- JSDoc 타입 → TypeScript 타입 주석
+- any 타입 남용 → 점진적 타입 강화
+
+## Tool Sequence
+1. `glob` — 프로젝트 내 .js/.jsx 파일 목록 수집
+2. `file_read` — package.json, 기존 설정 파일 확인
+3. `shell_exec` — `npx tsc --init` 또는 tsconfig.json 생성/수정
+4. `file_edit` — .js → .ts 확장자 변경 (점진적, 의존성 순서)
+5. `shell_exec` — 각 변환 후 `tsc --noEmit` 검증
+6. `file_edit` — import 경로 업데이트
+
+## Validation Checklist
+- [ ] tsconfig.json 적절히 설정됨
+- [ ] 핵심 파일 .ts로 변환 완료
+- [ ] 타입 에러 0개 (또는 @ts-ignore로 표시된 의도적 무시만)
+- [ ] 빌드 성공
+- [ ] 기존 테스트 통과

package/plugins/typescript/skills/refactor.md

@@ -0,0 +1,22 @@
+## Identity
+TypeScript 타입 안전 리팩토링 전문가. 타입 시스템을 활용하여 안전하게 코드 구조를 개선.
+
+## Known Error Patterns
+- 리팩토링 후 타입 불일치 → 제네릭/유니온 타입으로 해결
+- 인터페이스 변경 시 구현체 미반영 → 모든 implements 검색 후 업데이트
+- 함수 시그니처 변경 → 모든 호출처 업데이트 (grep + file_edit)
+- 네임스페이스 충돌 → re-export 또는 alias
+
+## Tool Sequence
+1. `code_search` — 리팩토링 대상 심볼의 모든 참조 찾기
+2. `file_read` — 대상 파일과 의존 파일 분석
+3. `file_edit` — 인터페이스/타입 먼저 수정 (SSOT)
+4. `file_edit` — 구현체 수정
+5. `shell_exec` — `tsc --noEmit` 타입 체크
+6. `shell_exec` — 테스트 실행
+
+## Validation Checklist
+- [ ] tsc --noEmit 에러 0개
+- [ ] 모든 참조 업데이트됨 (grep 결과 0건)
+- [ ] 테스트 통과
+- [ ] 코드 라인 수 동일 또는 감소

package/plugins/typescript/skills/strict-mode.md

@@ -0,0 +1,23 @@
+## Identity
+TypeScript strict 모드 전문가. tsconfig.json의 strict 옵션을 활성화하고 기존 코드를 마이그레이션.
+
+## Known Error Patterns
+- `TS7006: Parameter 'x' implicitly has an 'any' type` → 명시적 타입 주석 추가
+- `TS2322: Type 'null' is not assignable` → strict null checks, optional chaining 적용
+- `TS2532: Object is possibly 'undefined'` → null guard 추가 또는 non-null assertion
+- `TS7053: Element implicitly has an 'any' type` → Record<string, T> 또는 index signature
+- `TS2345: Argument of type 'string' is not assignable to parameter of type 'never'` → union type 확인
+
+## Tool Sequence
+1. `file_read` — tsconfig.json 현재 strict 설정 확인
+2. `shell_exec` — `tsc --noEmit --strict 2>&1` 로 에러 목록 수집
+3. `grep` — 에러 파일별 그룹핑
+4. `file_edit` — 가장 빈도 높은 에러부터 수정
+5. `shell_exec` — `tsc --noEmit` 재검증
+
+## Validation Checklist
+- [ ] tsconfig.json strict: true 설정됨
+- [ ] noImplicitAny: true
+- [ ] strictNullChecks: true
+- [ ] tsc --noEmit 에러 0개
+- [ ] 기존 런타임 동작 변경 없음

package/plugins/typescript/strategies/strict-migration.json

@@ -0,0 +1,37 @@
+{
+  "id": "strict-migration",
+  "name": "TypeScript Strict Mode Migration",
+  "description": "점진적 strict 모드 활성화 전략",
+  "phases": [
+    {
+      "name": "audit",
+      "tools": ["file_read", "shell_exec"],
+      "maxIterations": 2,
+      "successCriteria": "현재 strict 설정 파악 + 에러 수 측정"
+    },
+    {
+      "name": "enable-noImplicitAny",
+      "tools": ["file_edit", "shell_exec"],
+      "maxIterations": 20,
+      "successCriteria": "noImplicitAny 에러 0개"
+    },
+    {
+      "name": "enable-strictNullChecks",
+      "tools": ["file_edit", "shell_exec"],
+      "maxIterations": 20,
+      "successCriteria": "strictNullChecks 에러 0개"
+    },
+    {
+      "name": "enable-full-strict",
+      "tools": ["file_edit", "shell_exec"],
+      "maxIterations": 10,
+      "successCriteria": "strict: true, 에러 0개"
+    },
+    {
+      "name": "verify",
+      "tools": ["shell_exec"],
+      "maxIterations": 1,
+      "successCriteria": "tsc --noEmit --strict 에러 0개 + 테스트 통과"
+    }
+  ]
+}

package/plugins/typescript/strategies/type-error-fix.json

@@ -0,0 +1,37 @@
+{
+  "id": "type-error-fix",
+  "name": "TypeScript Type Error Fix Strategy",
+  "description": "TS 타입 에러를 체계적으로 수정하는 전략",
+  "phases": [
+    {
+      "name": "collect",
+      "tools": ["shell_exec"],
+      "maxIterations": 1,
+      "successCriteria": "tsc --noEmit 출력 수집 완료"
+    },
+    {
+      "name": "categorize",
+      "tools": ["grep"],
+      "maxIterations": 2,
+      "successCriteria": "에러를 TS 코드별로 분류"
+    },
+    {
+      "name": "fix-critical",
+      "tools": ["file_read", "file_edit"],
+      "maxIterations": 10,
+      "successCriteria": "TS2304 (missing), TS1005 (syntax) 에러 0개"
+    },
+    {
+      "name": "fix-types",
+      "tools": ["file_read", "file_edit"],
+      "maxIterations": 15,
+      "successCriteria": "TS2322, TS2339, TS2345 에러 0개"
+    },
+    {
+      "name": "verify",
+      "tools": ["shell_exec"],
+      "maxIterations": 1,
+      "successCriteria": "tsc --noEmit 에러 0개"
+    }
+  ]
+}

package/plugins/typescript/validators/rules.json

@@ -0,0 +1,28 @@
+{
+  "validators": [
+    {
+      "id": "tsc-noEmit",
+      "stage": "post",
+      "name": "TypeScript Compile Check",
+      "check": "tsc --noEmit"
+    },
+    {
+      "id": "no-any-added",
+      "stage": "quality",
+      "name": "No New Any Types",
+      "check": "git diff --cached | grep '+.*: any' | wc -l"
+    },
+    {
+      "id": "no-ts-ignore",
+      "stage": "quality",
+      "name": "No New @ts-ignore",
+      "check": "git diff --cached | grep '+.*@ts-ignore' | wc -l"
+    },
+    {
+      "id": "strict-deps",
+      "stage": "safety",
+      "name": "Dependencies Type Safety",
+      "check": "tsc --noEmit --strict"
+    }
+  ]
+}