intentpatch 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,437 @@
-# 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.
+**English** | [한국어](./README.ko.md)
+
+[![CI](https://github.com/xx2xxjaeil/intent-patch/actions/workflows/ci.yml/badge.svg)](https://github.com/xx2xxjaeil/intent-patch/actions/workflows/ci.yml)
+
+> Evidence-based change-scope analysis for code written by AI coding agents
+
+AI coding agents such as Codex, Claude Code, and Cursor can change many files from a short request. As the patch grows, it becomes harder to answer a few important questions:
+
+- Did the agent change files outside the requested scope?
+- Did it recreate logic that already existed?
+- Did it add an unnecessary dependency or abstraction?
+- How far can the change affect other modules?
+- Were relevant tests changed with the production code?
+
+IntentPatch combines **Git diff analysis, static analysis, and dependency analysis** to answer those questions. Its core analysis is deterministic and works without an LLM. Optional AI explanations can be added later without making the core tool dependent on a model provider.
+
+## Quick start
+
+IntentPatch requires Node.js 20 or later and Git. Until the first public npm release is approved, build and run it directly from the repository:
+
+```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
+```
+
+After the npm release becomes public, run the same CLI without installing it globally:
+
+```bash
+npx intentpatch analyze --cwd /path/to/repository
+npx intentpatch analyze --format html --output intentpatch-report.html
+```
+
+The core analyzer needs no API key, paid AI model, server, or database. Repository files are processed locally, and no LLM is used in the default execution path.
+
+## GitHub Action
+
+Use IntentPatch in pull requests to check scope and risky changes automatically. The checkout must include the full Git history so the action can compare the exact base and head commits.
+
+```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
+```
+
+The development version currently runs from `@main`. After the first stable release, pin the action to an immutable commit SHA or a major tag such as `@v1`.
+
+The action detects the comparison range for pull request and push events and produces:
+
+- a Markdown report in the GitHub Actions Job Summary;
+- workflow annotations grouped by severity;
+- JSON and HTML reports that can be uploaded as artifacts;
+- a quality gate at the `high`, `medium`, or `low` threshold;
+- action outputs containing finding counts and report paths.
+
+See the [GitHub Action guide](./docs/github-action.md) for inputs, outputs, and event-specific comparison behavior.
+
+## What the report looks like
+
+```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    Breaking change to a public function signature
+MEDIUM  Implementation duplicates existing authentication logic
+MEDIUM  Four files changed outside the expected scope
+LOW     New abstraction has only one implementation
+```
+
+Every finding includes the relevant file, a stable rule ID, and evidence for the decision instead of only presenting an unexplained warning.
+
+## Implemented capabilities
+
+The current version analyzes Git changes, direct dependencies in the root `package.json`, top-level TypeScript symbols and public API changes, possible duplicate implementations, single-implementation abstractions, import-graph impact, and related test changes.
+
+### Git and reporting
+
+- Compare `HEAD` with the current working tree.
+- Compare two Git references or branches from their merge base.
+- Classify added, modified, deleted, and renamed files.
+- Count added and deleted lines per file.
+- Distinguish binary files.
+- Include untracked files in working-tree analysis.
+- Render terminal-friendly text and machine-readable JSON reports.
+- Generate a standalone HTML report containing summary cards, findings, test signals, and an impact graph.
+- Render the visualization with inline CSS and SVG, without a CDN or runtime JavaScript dependency.
+- Aggregate findings by `high`, `medium`, and `low` severity.
+- Return a CI-friendly exit code through `--fail-on`.
+- Print the installed package version through `--version`.
+
+### Dependencies and TypeScript structure
+
+- Detect additions to production and development dependencies.
+- Detect dependency removal, version changes, and section moves.
+- Report malformed `package.json` files as evidence-backed findings instead of crashing.
+- Extract top-level named functions, classes, interfaces, and type aliases from `.ts` and `.tsx` files.
+- Detect symbol additions, modifications, and removals with source locations.
+- Preserve direct exports, local export lists, and external re-exports as public-symbol evidence.
+- Report removed public symbols and removed exports as high-severity compatibility risks.
+- Detect removed public function call signatures and incompatible public interface changes.
+- Exclude overloads that only gain an implementation while reporting previously available overloads that disappear.
+- Find newly added functions whose normalized implementation matches an existing function.
+- Report a newly added interface when exactly one class explicitly implements it.
+- Compare symbols correctly across renamed files.
+- Preserve syntax errors as analysis evidence instead of silently dropping a file.
+
+### Impact, scope, and tests
+
+- Build relative static import and re-export relationships for `.ts` and `.tsx` files.
+- Resolve `.js`, `.jsx`, `.mjs`, and `.cjs` import specifiers to matching TypeScript sources.
+- Calculate direct importers and transitively impacted files for changed modules.
+- Preserve unresolved relative imports and file read or parse failures as evidence.
+- Build the graph at the same result point as the diff: the working tree or the selected head ref.
+- Read intent, expected paths, allowed paths, and change budgets from `.intentpatch.json`.
+- Report each file outside expected and allowed patterns as a medium-severity finding.
+- Report file-count and measurable-line budget overruns with numeric evidence.
+- Classify source and test paths declared by the contract and connect related changes by basename.
+- Report test file counts and added or deleted tests as separate facts.
+- Report source files without a related test change as medium-severity findings.
+- Support repository-relative `*`, `**`, and `?` path patterns.
+
+Lockfile transitive dependency analysis, path aliases, JavaScript and method-level structure analysis, and optional AI review are not implemented yet.
+
+## CLI usage
+
+Analyze the current repository's working tree:
+
+```bash
+node dist/presentation/cli/main.js analyze
+```
+
+Analyze another Git repository:
+
+```bash
+node dist/presentation/cli/main.js analyze --cwd /path/to/repository
+```
+
+Compare two branches. IntentPatch analyzes their changes from the merge base:
+
+```bash
+node dist/presentation/cli/main.js analyze \
+  --cwd /path/to/repository \
+  --base main \
+  --head feature/account-deletion
+```
+
+Write JSON output:
+
+```bash
+node dist/presentation/cli/main.js analyze --json
+```
+
+Create a standalone HTML report:
+
+```bash
+node dist/presentation/cli/main.js analyze \
+  --format html \
+  --output intentpatch-report.html
+```
+
+The HTML file contains all styles and the dependency-impact SVG, so it opens directly without a server or API key. `--output` also works with text and JSON formats. Relative output paths are resolved from the directory where IntentPatch is executed. `--json` is an alias for `--format json`.
+
+### Check request scope with a Change Contract
+
+Create `.intentpatch.json` in the repository being analyzed and declare the expected scope of the request:
+
+```json
+{
+  "intent": "Implement account deletion",
+  "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`: paths expected to change for the request;
+- `allow`: exceptional paths such as configuration or lockfiles;
+- `maxFiles`: maximum number of changed files;
+- `maxLines`: maximum total of measurable added and deleted lines;
+- `tests.requireFor`: source paths that require a related test change;
+- `tests.include`: paths classified as tests;
+- `tests.exclude`: generated or declaration files excluded from the source check.
+
+Test matching uses basenames for deterministic results. For example, `src/user.ts` can match changed files such as `tests/user.test.ts`, `user.spec.ts`, or `user.integration.test.ts`.
+
+Use `--config` to select another contract. Relative paths are resolved from `--cwd`:
+
+```bash
+node dist/presentation/cli/main.js analyze \
+  --cwd /path/to/repository \
+  --config contracts/delete-user.json
+```
+
+Start with [`.intentpatch.example.json`](./.intentpatch.example.json). Without a contract, all existing analysis still runs and only the scope rules are disabled.
+
+### Quality gates
+
+Return exit code `1` after rendering the report when a finding meets or exceeds the selected severity:
+
+```bash
+node dist/presentation/cli/main.js analyze --fail-on medium
+```
+
+`medium` reacts to both medium- and high-severity findings. `low` treats every finding as a quality-gate failure. Invalid CLI usage returns exit code `2`.
+
+An evidence-rich result looks like this:
+
+```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.
+```
+
+Run the TypeScript entry point directly during development:
+
+```bash
+npm run dev -- analyze --cwd /path/to/repository
+```
+
+## Architecture
+
+IntentPatch applies Clean Architecture dependency direction so Git, presentation, and analysis rules do not become tightly coupled as the project grows.
+
+```text
+presentation ───────▶ application ───────▶ domain
+      │                     ▲
+      └──▶ infrastructure ──┘
+```
+
+| Layer | Responsibility |
+| --- | --- |
+| `domain` | Core models for changed files, Change Contracts, findings, symbol changes, and dependency impact |
+| `application` | Analysis use cases, rule engine, symbol and impact calculations, and ports for external data |
+| `infrastructure` | Git commands, diff parsing, project-file access, and TypeScript AST parsing |
+| `presentation` | CLI argument handling, dependency composition, and text, JSON, and HTML output |
+
+Architecture tests enforce the import direction so inner layers never depend on external implementations. See the [architecture document](./docs/architecture.md) for design decisions and extension points.
+
+## Design principles
+
+- **Deterministic first:** the same input produces the same core analysis result.
+- **Evidence over claims:** uncertain signals are not presented as facts.
+- **LLM optional:** useful analysis remains available without an AI provider.
+- **Dependency minimalism:** convenience alone does not justify another library.
+- **Explicit boundaries:** domain logic stays separate from external details such as Git and CLI frameworks.
+
+## Testing and quality checks
+
+```bash
+npm run check
+```
+
+This command runs:
+
+- strict TypeScript type checking;
+- Biome lint and format checks;
+- domain and use-case unit tests;
+- integration tests against real temporary Git repositories;
+- a package integration test that installs the generated npm tarball in a temporary project and executes it;
+- architecture tests that enforce dependency direction;
+- a reproducibility check for the bundled GitHub Action.
+
+Run only the production build with:
+
+```bash
+npm run build
+```
+
+Inspect the files that would be published without creating a public release:
+
+```bash
+npm pack --dry-run
+```
+
+## Release process
+
+Pushing a tag such as `v0.1.0`, matching the version in `package.json`, from a commit contained in the default branch triggers the release workflow:
+
+1. Validate the tag, package version, and default-branch ancestry.
+2. Run the full quality suite and inspect the npm package with a dry run.
+3. Publish through npm Trusted Publishing with OpenID Connect.
+4. Create a GitHub Release with automatically generated notes.
+
+No long-lived npm token is stored as a GitHub secret. Public packages published through OIDC receive npm provenance automatically. A package that does not yet exist on npm needs a one-time bootstrap before a Trusted Publisher can be configured. See the [release operations guide](./docs/releasing.md) for bootstrap and subsequent release procedures.
+
+## Roadmap
+
+1. ✅ Direct `package.json` dependency detection and rule engine
+2. ✅ TypeScript AST analysis for functions, classes, interfaces, and types
+3. ✅ Relative static import graph and change-impact calculation
+4. ✅ Change Contract scope and change-budget analysis
+5. ✅ Contract-based detection of missing related test changes
+6. Package-manager adapters for lockfiles and workspaces
+7. ✅ Detection of removed public exports
+8. ✅ Standalone HTML dashboard and SVG dependency-impact graph
+9. ✅ Re-export and function/interface compatibility checks plus possible code duplication
+10. ✅ Detection of newly introduced single-implementation interfaces
+11. ✅ GitHub Action with PR/push comparison, Job Summary, annotations, and artifacts
+12. Codex, Claude Code, and Cursor adapters
+13. Optional LLM explanations grounded in deterministic evidence
+
+## Current limitations
+
+- The target must be a Git repository with at least one commit.
+- Untracked symbolic links are not read for safety.
+- Line counts are skipped for untracked files larger than 10 MiB.
+- Dependency analysis covers only `dependencies` and `devDependencies` in the root npm `package.json`.
+- Transitive lockfile dependencies, workspace packages, and real dependency usage in source code are not analyzed yet.
+- Symbol analysis supports named top-level functions, classes, interfaces, and type aliases in `.ts` and `.tsx` files.
+- Public API analysis supports named top-level functions and interfaces, local `export { name }`, external `export { name } from`, and `export * from`. Package `exports`, anonymous default exports, and detailed class or type-alias contracts are not interpreted yet.
+- Function compatibility compares explicitly written parameter and return-type text. It does not evaluate inferred return types or full TypeScript structural assignability.
+- Duplicate candidates require a newly added top-level function and an existing top-level function to have exactly the same normalized tokens after comments and whitespace are removed, with at least 12 body tokens. Renamed identifiers, methods, and semantically equivalent implementations are not detected.
+- A single-implementation abstraction is reported only when exactly one named class explicitly uses `implements` for a new interface. Structural implementation, factory return types, and runtime registration are not calculated.
+- Methods, variable declarations, enums, nested declarations, and JavaScript files are not included in symbol analysis.
+- Formatting or comment changes inside a declaration can be counted as symbol modifications.
+- Impact analysis covers relative static `import`, side-effect imports, `export ... from`, and `import = require()` in `.ts` and `.tsx` files.
+- External package imports, path aliases, dynamic `import()`, and ordinary `require()` are not included in the graph.
+- The graph is built from files at the comparison result point: the working tree or head ref. Impact from historical imports that referenced a deleted module cannot be calculated yet.
+- Source files used for impact analysis are limited to 1 MiB per file, and symbolic links are not read.
+- IntentPatch does not infer expected paths from natural-language intent. Scope decisions use the contract's explicit `include` and `allow` patterns.
+- Path patterns support only repository-relative `*`, `**`, and `?`; negation and brace expansion are not supported.
+- `maxLines` sums only measurable added and deleted lines in text files. Binary or unmeasurable files are not treated as zero lines, but their size is not included in the budget.
+- Test analysis compares only the changed paths declared in the contract; it does not execute tests or measure coverage.
+- Related tests are matched by basename. Integration tests with different names or one test covering several source files cannot be linked automatically yet.
+- The HTML impact graph uses a deterministic two-column layout. Interactive node movement, zooming, and filtering are not implemented yet.
+
+## License
+
+[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

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

@@ -0,0 +1 @@
+{"version":3,"file":"module-reference-extractor.d.ts","sourceRoot":"","sources":["../../../src/application/ports/module-reference-extractor.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,+BAA+B,GACvC,QAAQ,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,GAC5D,QAAQ,CAAC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtD,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,+BAA+B,CAAC;CACxE"}

package/dist/application/ports/module-reference-extractor.js

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

package/dist/application/ports/module-reference-extractor.js.map

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

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

@@ -0,0 +1,16 @@
+import type { AnalysisTarget } from "../../domain/report.js";
+export type ProjectFileReadResult = Readonly<{
+    kind: "success";
+    content: string;
+}> | Readonly<{
+    kind: "missing";
+}> | Readonly<{
+    kind: "unavailable";
+    reason: string;
+}>;
+/** 분석 결과점의 프로젝트 파일 목록과 텍스트를 공급하는 출력 포트다. */
+export interface ProjectFileSource {
+    listPaths(target: AnalysisTarget): Promise<readonly string[]>;
+    read(target: AnalysisTarget, path: string): Promise<ProjectFileReadResult>;
+}
+//# sourceMappingURL=project-file-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-file-source.d.ts","sourceRoot":"","sources":["../../../src/application/ports/project-file-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,QAAQ,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC7B,QAAQ,CAAC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5E"}