intentpatch 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IntentPatch contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,453 @@
-# Temporary Holding Version
+# IntentPatch
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/xx2xxjaeil/intent-patch/actions/workflows/ci.yml/badge.svg)](https://github.com/xx2xxjaeil/intent-patch/actions/workflows/ci.yml)
+
+> AI 코딩 에이전트가 만든 변경을 근거 중심으로 분석하는 오픈소스 도구
+
+Codex, Claude Code, Cursor 같은 AI 코딩 에이전트는 짧은 요청만으로 여러 파일을 빠르게
+수정합니다. 하지만 변경된 파일이 많아질수록 다음 질문에 답하기 어려워집니다.
+
+- 요청한 범위보다 많은 파일을 수정하지 않았는가?
+- 기존 코드를 재사용하지 않고 비슷한 로직을 새로 만들지 않았는가?
+- 불필요한 라이브러리나 추상화를 추가하지 않았는가?
+- 이번 변경이 다른 모듈에 어디까지 영향을 주는가?
+- 중요한 동작에 대한 테스트가 함께 추가되었는가?
+
+IntentPatch는 이러한 질문에 답하기 위해 **Git diff, 정적 분석, 의존 관계 분석**을 결합합니다.
+LLM 없이도 재현 가능한 분석을 제공하고, AI 설명 기능은 선택적으로 결합하는 것을 목표로
+합니다.
+
+## 빠른 시작
+
+Node.js 20 이상과 Git이 설치되어 있어야 합니다. 현재 npm 공개 전에는 저장소를 빌드해 바로
+실행할 수 있습니다.
+
+```bash
+git clone https://github.com/xx2xxjaeil/intent-patch.git
+cd intent-patch
+npm ci
+npm run build
+node dist/presentation/cli/main.js --version
+node dist/presentation/cli/main.js analyze --cwd /path/to/repository
+```
+
+npm 릴리스가 공개된 뒤에는 설치 없이 같은 CLI를 실행할 수 있습니다.
+
+```bash
+npx intentpatch analyze --cwd /path/to/repository
+npx intentpatch analyze --format html --output intentpatch-report.html
+```
+
+핵심 분석에는 API key, 유료 AI 모델, 서버 또는 데이터베이스가 필요하지 않습니다. 분석할 Git
+저장소의 파일은 로컬에서 처리하며 LLM 연결은 현재 기본 실행 경로에 포함되지 않습니다.
+
+## GitHub Action
+
+Pull Request에서 요청 범위와 위험 변경을 자동 검사할 수 있습니다. 정확한 base·head commit을
+사용하도록 checkout의 전체 히스토리를 가져와야 합니다.
+
+```yaml
+name: IntentPatch
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Analyze pull request
+        id: intentpatch
+        uses: xx2xxjaeil/intent-patch@main
+        with:
+          fail-on: high
+
+      - name: Upload reports
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: intentpatch-report
+          path: intentpatch-report
+```
+
+현재 개발 버전은 `@main`으로 실행합니다. 첫 번째 정식 릴리스 후에는 불변 SHA 또는 `@v1`
+태그로 고정하는 방식을 권장합니다. Action은 PR·push 이벤트의 commit 범위를 자동으로
+선택하고 다음 결과를 남깁니다.
+
+- GitHub Actions Job Summary의 Markdown 보고서
+- 심각도별 workflow annotation
+- artifact 업로드에 사용할 JSON·HTML 보고서
+- `high`, `medium`, `low` 기준의 품질 게이트
+- finding 수와 보고서 경로 Action output
+
+입력·출력과 이벤트별 비교 기준은 [GitHub Action 사용 문서](./docs/github-action.md)에서
+확인할 수 있습니다.
+
+## 프로젝트가 지향하는 결과
+
+```text
+IntentPatch Change Report
+
+Target               HEAD → working tree
+Files changed        12
+Lines                +438 / -51
+Direct dependents    2
+Transitive impact    4
+Tests changed        3
+Missing test changes 1
+New dependencies     2
+Risky API changes    1
+Duplicate candidates 1
+Single implementations 1
+
+Impacted files
+
+→  direct              src/api/delete-user.ts
+   changed: src/lib/auth.ts
+→  transitive · 2 hops src/app.ts
+   changed: src/lib/auth.ts
+
+Potential issues
+
+HIGH    공개 함수 시그니처 호환성 파괴
+MEDIUM  기존 인증 로직과 동일한 구현 발견
+MEDIUM  요청과 관련성이 낮아 보이는 파일 4개 변경
+LOW     구현체가 하나뿐인 추상화 추가
+```
+
+분석 결과는 단순한 경고 문구가 아니라 관련 파일, 규칙 ID, 판단 근거와 함께 제공하는 것을
+원칙으로 합니다.
+
+## 현재 구현된 기능
+
+현재 버전은 Git 변경사항 수집, 루트 `package.json`의 직접 dependency 분석, TypeScript
+최상위 심볼과 공개 API 변경 분석, 기존 구현 중복·단일 구현 추상화 신호, import graph 기반
+영향 범위와 테스트 동반 변경 분석을 제공합니다.
+
+- `HEAD`와 현재 working tree 비교
+- 두 Git reference 또는 브랜치 비교
+- 추가, 수정, 삭제, 이름 변경 등 파일 상태 분류
+- 파일별 추가·삭제 라인 수 계산
+- binary 파일 구분
+- working tree 분석 시 untracked 파일 포함
+- 터미널용 텍스트 보고서
+- 후속 도구 연동을 위한 JSON 보고서
+- 요약 카드, finding, 테스트 신호와 영향 그래프를 담은 단일 HTML 보고서
+- 외부 CDN이나 JavaScript dependency가 필요 없는 인라인 CSS·SVG 시각화
+- production·development dependency 추가 탐지
+- dependency 삭제, 버전 변경, 섹션 이동 탐지
+- 잘못된 `package.json`을 예외 대신 근거가 포함된 finding으로 보고
+- finding 심각도(`high`, `medium`, `low`) 집계
+- CI 품질 게이트를 위한 `--fail-on` 종료 코드
+- 설치된 패키지 버전을 확인하는 `--version` 명령
+- `.ts`·`.tsx` 파일의 최상위 함수·클래스·인터페이스·타입 별칭 추출
+- 심볼 추가·수정·삭제 탐지와 소스 위치 표시
+- 직접 `export`된 선언, 로컬 export 목록과 외부 re-export를 공개 심볼 근거에 보존
+- 공개 심볼 삭제와 `export` 해제를 호환성 위험 `high` finding으로 탐지
+- 공개 함수의 기존 호출 시그니처 제거와 공개 인터페이스의 호환성 파괴를 `high` finding으로 탐지
+- 구현이 추가된 기존 overload는 제외하고 기존 overload가 사라진 경우만 함수 계약 변경으로 판정
+- 공백과 주석을 제외한 구현 토큰이 같은 신규 함수와 기존 함수를 재사용 후보 `medium` finding으로 탐지
+- 신규 인터페이스를 명시적으로 구현하는 클래스가 하나뿐이면 추상화 검토 `low` finding으로 탐지
+- rename 전후 파일 경로를 사용한 심볼 비교
+- 구문 오류가 있는 파일을 누락시키지 않고 분석 불가 근거로 보고
+- `.ts`·`.tsx` 파일의 상대 경로 정적 import와 re-export 관계 수집
+- `.js`·`.jsx`·`.mjs`·`.cjs` specifier를 대응하는 TypeScript 소스로 해석
+- 변경 모듈을 import하는 직접 의존자와 여러 단계를 거친 간접 영향 파일 계산
+- 해결하지 못한 상대 import와 읽기·파싱 실패를 분석 근거로 보존
+- working tree의 tracked·untracked 파일 또는 지정한 head ref를 동일한 결과점에서 분석
+- `.intentpatch.json`에 요청 의도, 예상 경로, 허용 경로와 변경량 예산 선언
+- 예상·허용 패턴을 벗어난 변경 파일을 파일별 `medium` finding으로 탐지
+- 변경 파일 수와 측정 라인 예산 초과를 수치 근거가 있는 `low` finding으로 탐지
+- Contract가 지정한 소스·테스트 경로를 분류하고 파일명 기준으로 관련 변경 연결
+- 테스트 변경 수와 추가·삭제 수를 별도의 분석 사실로 집계
+- 관련 테스트 변경이 없는 소스 파일을 `medium` finding으로 탐지
+- `*`, `**`, `?` 기반의 저장소 상대 경로 패턴 지원
+- Pull Request·push commit 범위를 자동 판별하는 GitHub Action
+- GitHub Job Summary, workflow annotation, JSON·HTML artifact용 보고서 생성
+
+아직 lockfile의 전이 dependency 분석, path alias 해석, JavaScript·메서드 구조 분석과 AI 리뷰
+기능은 구현되지 않았습니다.
+
+## 상세 사용법
+
+현재 저장소의 working tree를 분석합니다.
+
+```bash
+node dist/presentation/cli/main.js analyze
+```
+
+다른 Git 저장소를 분석할 수도 있습니다.
+
+```bash
+node dist/presentation/cli/main.js analyze --cwd /path/to/repository
+```
+
+두 브랜치를 비교합니다. 내부적으로 merge base 기준의 변경사항을 분석합니다.
+
+```bash
+node dist/presentation/cli/main.js analyze \
+  --cwd /path/to/repository \
+  --base main \
+  --head feature/account-deletion
+```
+
+JSON으로 출력합니다.
+
+```bash
+node dist/presentation/cli/main.js analyze --json
+```
+
+브라우저에서 볼 수 있는 HTML 보고서를 파일로 생성합니다.
+
+```bash
+node dist/presentation/cli/main.js analyze \
+  --format html \
+  --output intentpatch-report.html
+```
+
+HTML 파일에는 스타일과 dependency 영향 SVG 그래프가 모두 포함되므로 별도 서버나 API key 없이
+바로 열 수 있습니다. `--output`은 텍스트와 JSON 형식에도 사용할 수 있으며 상대 경로는
+IntentPatch를 실행한 현재 디렉터리를 기준으로 해석합니다. 기존 `--json`은
+`--format json`의 단축 옵션입니다.
+
+### Change Contract로 요청 범위 검사
+
+분석할 저장소의 `.intentpatch.json`에 이번 요청의 기대 범위를 선언할 수 있습니다.
+
+```json
+{
+  "intent": "회원 탈퇴 기능 구현",
+  "scope": {
+    "include": ["src/user/**", "tests/user/**"],
+    "allow": ["package.json", "package-lock.json"],
+    "maxFiles": 8,
+    "maxLines": 300
+  },
+  "tests": {
+    "requireFor": ["src/**/*.ts", "src/**/*.tsx"],
+    "include": ["tests/**/*.test.ts", "tests/**/*.test.tsx"],
+    "exclude": ["src/**/*.d.ts"]
+  }
+}
+```
+
+- `include`: 요청 수행 중 변경될 것으로 예상한 경로
+- `allow`: 설정이나 lockfile처럼 함께 변경되어도 허용하는 예외 경로
+- `maxFiles`: 변경 파일 수의 상한
+- `maxLines`: 측정 가능한 추가·삭제 라인 합의 상한
+- `tests.requireFor`: 테스트 동반 변경을 확인할 소스 경로
+- `tests.include`: 테스트 파일로 분류할 경로
+- `tests.exclude`: 생성 파일이나 선언 파일처럼 검사에서 제외할 소스 경로
+
+테스트 연결은 결정적인 결과를 위해 파일명을 사용합니다. 예를 들어 `src/user.ts`는
+`tests/user.test.ts`, `user.spec.ts`, `user.integration.test.ts` 같은 변경과 연결됩니다.
+
+기본 파일 대신 별도 계약을 사용하려면 `--config`를 지정합니다. 상대 경로는 `--cwd`를 기준으로
+해석합니다.
+
+```bash
+node dist/presentation/cli/main.js analyze \
+  --cwd /path/to/repository \
+  --config contracts/delete-user.json
+```
+
+복사해서 시작할 수 있는 설정은 [`.intentpatch.example.json`](./.intentpatch.example.json)에
+있습니다. Contract가 없으면 기존 분석은 그대로 실행되고 scope 규칙만 비활성화됩니다.
+
+지정한 심각도 이상의 finding이 있으면 보고서를 출력한 뒤 종료 코드 `1`을 반환합니다.
+
+```bash
+node dist/presentation/cli/main.js analyze --fail-on medium
+```
+
+`medium`은 `medium`과 `high` finding에 반응하며, `low`를 지정하면 모든 finding을 품질
+게이트 대상으로 취급합니다. 잘못된 CLI 사용은 종료 코드 `2`를 반환합니다.
+
+dependency 변경과 코드 영향 범위를 다음과 같이 근거와 함께 출력합니다.
+
+```text
+IntentPatch Change Report
+
+Files changed        2
+Changed symbols      2
+Import edges         18
+Direct dependents    1
+Transitive impact    2
+Tests changed        1
+Tests added          0
+Missing test changes 1
+New dependencies     1
+Risky API changes    1
+Duplicate candidates 1
+Single implementations 1
+Findings             6
+
+Changed symbols
+
+M  Class         UserService                  src/user/service.ts:12
+A  Function      deleteUser                   src/user/service.ts:48
+
+Impacted files
+
+→  direct              src/api/delete-user.ts
+   changed: src/user/service.ts
+→  transitive · 2 hops src/app.ts
+   changed: src/user/service.ts
+
+Potential issues
+
+HIGH    Public export removed
+        src/user/service.ts · api/export-removed
+        The function deleteUser is no longer exported.
+
+MEDIUM  New production dependency
+        package.json · dependency/new-production
+        dayjs@^1.11.0 was added to dependencies.
+
+MEDIUM  Change outside expected scope
+        src/payment/billing.ts · scope/outside-expected-path
+        src/payment/billing.ts does not match any expected or allowed path pattern.
+
+MEDIUM  Source change without matching test change
+        src/payment/billing.ts · tests/missing-related-change
+        src/payment/billing.ts changed without a changed test sharing the same basename.
+
+MEDIUM  New function duplicates existing implementation
+        src/user/service.ts · structure/duplicate-implementation
+        The new function verifySession has the same normalized implementation as authorize.
+
+LOW     New interface has one implementation
+        src/user/service.ts · structure/single-implementation-abstraction
+        The new interface DeletionStrategy is implemented only by DefaultDeletionStrategy.
+```
+
+개발 중에는 빌드 없이 실행할 수 있습니다.
+
+```bash
+npm run dev -- analyze --cwd /path/to/repository
+```
+
+## 아키텍처
+
+기능이 늘어나도 Git, UI, 분석 규칙이 서로 강하게 결합되지 않도록 클린 아키텍처의 의존성
+방향을 적용했습니다.
+
+```text
+presentation ───────▶ application ───────▶ domain
+      │                     ▲
+      └──▶ infrastructure ──┘
+```
+
+| 계층 | 책임 |
+| --- | --- |
+| `domain` | 변경 파일, Change Contract, finding, 심볼 변경, dependency 영향 등 핵심 모델 |
+| `application` | 분석 유스케이스, 규칙 엔진, 심볼·영향 계산과 외부 데이터 포트 |
+| `infrastructure` | Git 명령·diff 파싱·프로젝트 파일 공급·TypeScript AST 파싱 |
+| `presentation` | CLI 인자 처리, 의존성 조립, 텍스트·JSON·HTML 출력 |
+
+하위 계층이 외부 구현을 참조하지 않도록 아키텍처 테스트가 import 방향을 검사합니다.
+구현상의 주요 판단과 확장 지점은 [상세 아키텍처 문서](./docs/architecture.md)에서 설명합니다.
+
+## 설계 원칙
+
+- **Deterministic first:** 핵심 분석은 동일한 입력에 동일한 결과를 반환합니다.
+- **Evidence over claims:** 확실하지 않은 판단을 사실처럼 단정하지 않습니다.
+- **LLM optional:** AI 연결 없이도 기본 분석 기능을 사용할 수 있어야 합니다.
+- **Dependency minimalism:** 편의를 위한 라이브러리를 무분별하게 추가하지 않습니다.
+- **Explicit boundaries:** 도메인 로직과 Git·CLI 같은 외부 기술을 분리합니다.
+
+## 테스트와 품질 검사
+
+```bash
+npm run check
+```
+
+위 명령은 다음 검사를 순서대로 실행합니다.
+
+- 엄격한 TypeScript 타입 검사
+- Biome 린트 및 포맷 검사
+- 도메인과 유스케이스 단위 테스트
+- 실제 임시 Git 저장소를 사용하는 통합 테스트
+- 생성한 npm tarball을 임시 프로젝트에 설치하고 실행하는 패키지 통합 테스트
+- 계층 간 의존 방향을 검증하는 아키텍처 테스트
+
+프로덕션 빌드만 확인하려면 다음 명령을 사용합니다.
+
+```bash
+npm run build
+```
+
+npm에 포함될 파일과 패키지 생성을 확인하려면 실제 공개 없이 dry-run을 실행합니다.
+
+```bash
+npm pack --dry-run
+```
+
+## 로드맵
+
+1. ✅ `package.json` 직접 dependency 변경 탐지와 규칙 엔진
+2. ✅ TypeScript AST 기반 함수·클래스·인터페이스·타입 변경 분석
+3. ✅ 상대 경로 정적 import graph 기반 변경 영향 범위 계산
+4. ✅ Change Contract 기반 예상 범위 이탈과 변경량 예산 탐지
+5. ✅ Contract 기반 관련 테스트 변경 누락 탐지
+6. lockfile과 workspace를 고려한 package manager adapter
+7. ✅ 직접 export된 공개 심볼 삭제와 export 해제 탐지
+8. ✅ 단일 HTML 대시보드와 SVG 기반 dependency 영향 그래프
+9. ✅ re-export·함수/인터페이스 호환성과 기존 코드 중복 가능성 탐지
+10. ✅ 구현체가 하나뿐인 신규 인터페이스 탐지
+11. ✅ PR·push 비교, Job Summary와 artifact 출력을 제공하는 GitHub Action
+12. Codex·Claude Code·Cursor adapter
+13. 근거 기반 결과에 대한 선택적 LLM 설명
+
+## 현재 제한사항
+
+- 분석 대상은 최소 한 번 이상 커밋된 Git 저장소여야 합니다.
+- untracked symbolic link는 안전을 위해 내용을 읽지 않습니다.
+- 10 MiB를 초과하는 untracked 파일은 라인 수를 측정하지 않습니다.
+- dependency 분석은 저장소 루트의 npm `package.json`에 선언된 `dependencies`와
+  `devDependencies`를 대상으로 합니다.
+- lockfile의 전이 dependency, workspace package, 코드에서의 실제 사용 여부는 아직 분석하지 않습니다.
+- 심볼 분석은 `.ts`와 `.tsx`의 이름이 있는 최상위 함수, 클래스, 인터페이스, 타입
+  별칭만 지원합니다.
+- 공개 API 분석은 이름이 있는 최상위 함수·인터페이스, 로컬 `export { name }`, 외부
+  `export { name } from`, `export * from`을 지원합니다. package `exports`, 익명 default export,
+  클래스·타입 별칭의 세부 계약은 아직 해석하지 않습니다.
+- 함수 호환성은 명시된 파라미터·반환 타입 텍스트를 비교합니다. 추론된 반환 타입 변화나
+  TypeScript의 구조적 타입 할당 가능성까지 판정하지 않습니다.
+- 중복 구현 후보는 새로 추가된 최상위 함수와 기존 최상위 함수의 토큰이 공백·주석을 제외하고
+  완전히 같으며 본문이 12토큰 이상일 때만 보고합니다. 식별자 이름이 바뀐 유사 코드, 메서드,
+  의미적으로만 같은 구현은 탐지하지 않습니다.
+- 단일 구현 추상화는 새 인터페이스를 `implements`로 명시한 이름 있는 클래스가 정확히 하나일 때만
+  보고합니다. TypeScript의 구조적 구현, factory 반환 타입과 런타임 등록은 계산하지 않습니다.
+- 메서드, 변수 선언, enum, 중첩 선언, JavaScript 파일은 아직 심볼 분석 대상이 아닙니다.
+- 선언 내부의 포맷이나 주석 변경도 심볼 수정으로 집계될 수 있습니다.
+- 영향 분석은 `.ts`·`.tsx` 파일의 상대 경로 정적 `import`, side-effect import,
+  `export ... from`, `import = require()`를 대상으로 합니다.
+- 외부 package import는 그래프에서 제외하며 path alias, dynamic `import()`, 일반 `require()`는
+  아직 해석하지 않습니다.
+- 영향 그래프는 비교 결과점(working tree 또는 head ref)의 파일을 기준으로 만듭니다. 따라서
+  삭제된 모듈을 가리키던 과거 import의 영향은 현재 단계에서 계산할 수 없습니다.
+- 영향 분석용 소스 파일은 파일당 1 MiB로 제한하며, symbolic link는 읽지 않습니다.
+- IntentPatch는 자연어 intent만으로 예상 경로를 추측하지 않습니다. 범위 판단은 Contract에 명시한
+  `include`와 `allow`를 기준으로 수행합니다.
+- 경로 패턴은 저장소 상대 경로와 `*`, `**`, `?`만 지원합니다. 부정 패턴과 brace 확장은 아직
+  지원하지 않습니다.
+- `maxLines`는 측정 가능한 텍스트 파일의 추가·삭제 라인만 합산합니다. Binary와 측정 불가 파일을
+  0줄이라고 간주하지 않지만, 해당 파일의 크기를 라인 예산에 포함하지도 않습니다.
+- 테스트 분석은 실행 결과나 코드 커버리지를 측정하지 않고 Contract에 지정된 변경 파일만
+  비교합니다.
+- 관련 테스트는 현재 소스와 테스트의 파일명이 같은지로 판단하므로 이름이 다른 통합 테스트나
+  하나의 테스트가 여러 소스를 검증하는 관계는 자동으로 연결하지 못합니다.
+- HTML 영향 그래프는 변경 모듈과 영향 파일을 결정적인 두 열 레이아웃으로 표시합니다. 노드 이동,
+  확대·축소와 필터링을 제공하는 대화형 웹 UI는 아직 구현하지 않았습니다.
+
+## 라이선스
+
+[MIT](./LICENSE)

package/dist/application/ports/analysis-rule.d.ts

@@ -0,0 +1,23 @@
+import type { ChangeSet } from "../../domain/change.js";
+import type { ChangeContract } from "../../domain/change-contract.js";
+import type { CodeStructureAnalysis } from "../../domain/code-structure.js";
+import type { Finding } from "../../domain/finding.js";
+import type { AnalysisTarget } from "../../domain/report.js";
+import type { SymbolChangeSet } from "../../domain/symbol-change.js";
+import type { TestChangeAnalysis } from "../../domain/test-change.js";
+export interface AnalysisContext {
+    readonly target: AnalysisTarget;
+    readonly changes: ChangeSet;
+    readonly contract?: ChangeContract;
+    readonly testChanges?: TestChangeAnalysis;
+    readonly symbolChanges?: SymbolChangeSet;
+    readonly codeStructure?: CodeStructureAnalysis;
+}
+/**
+ * 하나의 분석 관점을 캡슐화하는 규칙이다.
+ * 규칙은 외부 기술을 직접 호출하지 않고 필요한 포트를 생성자로 주입받는다.
+ */
+export interface AnalysisRule {
+    analyze(context: AnalysisContext): Promise<readonly Finding[]>;
+}
+//# sourceMappingURL=analysis-rule.d.ts.map

package/dist/application/ports/analysis-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-rule.d.ts","sourceRoot":"","sources":["../../../src/application/ports/analysis-rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC;CAChD;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;CAChE"}

package/dist/application/ports/analysis-rule.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analysis-rule.js.map

package/dist/application/ports/analysis-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-rule.js","sourceRoot":"","sources":["../../../src/application/ports/analysis-rule.ts"],"names":[],"mappings":""}

package/dist/application/ports/change-impact-analyzer.d.ts

@@ -0,0 +1,6 @@
+import type { ImpactAnalysis } from "../../domain/impact.js";
+import type { AnalysisContext } from "./analysis-rule.js";
+export interface ChangeImpactAnalyzer {
+    analyze(context: AnalysisContext): Promise<ImpactAnalysis>;
+}
+//# sourceMappingURL=change-impact-analyzer.d.ts.map

package/dist/application/ports/change-impact-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-impact-analyzer.d.ts","sourceRoot":"","sources":["../../../src/application/ports/change-impact-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5D"}

package/dist/application/ports/change-impact-analyzer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=change-impact-analyzer.js.map

package/dist/application/ports/change-impact-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-impact-analyzer.js","sourceRoot":"","sources":["../../../src/application/ports/change-impact-analyzer.ts"],"names":[],"mappings":""}

package/dist/application/ports/change-source.d.ts

@@ -0,0 +1,10 @@
+import type { ChangeSet } from "../../domain/change.js";
+import type { AnalysisTarget } from "../../domain/report.js";
+/**
+ * 변경사항을 가져오는 출력 포트다.
+ * 애플리케이션 계층은 이 인터페이스만 알기 때문에 Git 외의 데이터 소스도 교체할 수 있다.
+ */
+export interface ChangeSource {
+    collect(target: AnalysisTarget): Promise<ChangeSet>;
+}
+//# sourceMappingURL=change-source.d.ts.map

package/dist/application/ports/change-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-source.d.ts","sourceRoot":"","sources":["../../../src/application/ports/change-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACrD"}

package/dist/application/ports/change-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=change-source.js.map

package/dist/application/ports/change-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-source.js","sourceRoot":"","sources":["../../../src/application/ports/change-source.ts"],"names":[],"mappings":""}

package/dist/application/ports/code-structure-analyzer.d.ts

@@ -0,0 +1,6 @@
+import type { CodeStructureAnalysis } from "../../domain/code-structure.js";
+import type { AnalysisContext } from "./analysis-rule.js";
+export interface CodeStructureAnalyzer {
+    analyze(context: AnalysisContext): Promise<CodeStructureAnalysis>;
+}
+//# sourceMappingURL=code-structure-analyzer.d.ts.map

package/dist/application/ports/code-structure-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-structure-analyzer.d.ts","sourceRoot":"","sources":["../../../src/application/ports/code-structure-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnE"}

package/dist/application/ports/code-structure-analyzer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-structure-analyzer.js.map

package/dist/application/ports/code-structure-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-structure-analyzer.js","sourceRoot":"","sources":["../../../src/application/ports/code-structure-analyzer.ts"],"names":[],"mappings":""}

package/dist/application/ports/code-structure-extractor.d.ts

@@ -0,0 +1,33 @@
+export interface FunctionImplementationFact {
+    readonly name: string;
+    readonly line: number;
+    readonly implementationFingerprint: string;
+    readonly tokenCount: number;
+}
+export interface InterfaceDeclarationFact {
+    readonly name: string;
+    readonly line: number;
+}
+export interface ClassImplementationFact {
+    readonly name: string;
+    readonly line: number;
+    readonly implementedTypes: readonly string[];
+}
+export interface CodeStructureFacts {
+    readonly functions: readonly FunctionImplementationFact[];
+    readonly interfaces: readonly InterfaceDeclarationFact[];
+    readonly classes: readonly ClassImplementationFact[];
+}
+export type CodeStructureExtractionResult = Readonly<{
+    kind: "success";
+    facts: CodeStructureFacts;
+}> | Readonly<{
+    kind: "unavailable";
+    reason: string;
+}>;
+/** 언어별 소스에서 구조 신호에 필요한 최소 사실만 추출하는 입력 포트다. */
+export interface CodeStructureExtractor {
+    supports(path: string): boolean;
+    extract(path: string, source: string): CodeStructureExtractionResult;
+}
+//# sourceMappingURL=code-structure-extractor.d.ts.map

package/dist/application/ports/code-structure-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-structure-extractor.d.ts","sourceRoot":"","sources":["../../../src/application/ports/code-structure-extractor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACtD;AAED,MAAM,MAAM,6BAA6B,GACrC,QAAQ,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC,GACxD,QAAQ,CAAC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,6BAA6B,CAAC;CACtE"}

package/dist/application/ports/code-structure-extractor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-structure-extractor.js.map

package/dist/application/ports/code-structure-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-structure-extractor.js","sourceRoot":"","sources":["../../../src/application/ports/code-structure-extractor.ts"],"names":[],"mappings":""}

package/dist/application/ports/file-snapshot-source.d.ts

@@ -0,0 +1,10 @@
+import type { AnalysisTarget } from "../../domain/report.js";
+export interface TextFileSnapshot {
+    readonly before?: string;
+    readonly after?: string;
+}
+/** 분석 기준점과 결과점에서 동일한 텍스트 파일을 읽는 출력 포트다. */
+export interface FileSnapshotSource {
+    read(target: AnalysisTarget, path: string, basePath?: string): Promise<TextFileSnapshot>;
+}
+//# sourceMappingURL=file-snapshot-source.d.ts.map

package/dist/application/ports/file-snapshot-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-snapshot-source.d.ts","sourceRoot":"","sources":["../../../src/application/ports/file-snapshot-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1F"}

package/dist/application/ports/file-snapshot-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-snapshot-source.js.map

package/dist/application/ports/file-snapshot-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-snapshot-source.js","sourceRoot":"","sources":["../../../src/application/ports/file-snapshot-source.ts"],"names":[],"mappings":""}

package/dist/application/ports/module-reference-extractor.d.ts

@@ -0,0 +1,13 @@
+export type ModuleReferenceExtractionResult = Readonly<{
+    kind: "success";
+    specifiers: readonly string[];
+}> | Readonly<{
+    kind: "unavailable";
+    reason: string;
+}>;
+/** 소스 파일에서 정적 module specifier를 추출하는 언어별 출력 포트다. */
+export interface ModuleReferenceExtractor {
+    supports(path: string): boolean;
+    extract(path: string, source: string): ModuleReferenceExtractionResult;
+}
+//# sourceMappingURL=module-reference-extractor.d.ts.map