pal-crawl 2.0.5 → 2.2.1

package/.freebuff/project-id

@@ -0,0 +1 @@
+d56ee6eb-546a-4a34-a6c7-6c28626bb8b8

package/AGENTS.md

@@ -0,0 +1,347 @@
+# AGENTS.md
+
+에이전트(및 신규 기여자)가 이 저장소에서 작업할 때 따라야 지침입니다.
+규칙은 실제 코드와 Git 히스토리에서 도출했거나 여기서 확정한 것이며,
+어긋나면 코드를 규칙에 맞출 것.
+
+**목차**: [프로젝트 개요](#프로젝트-개요) · [저장소 구조](#저장소-구조) · [개발 명령어](#개발-명령어) ·
+[TypeScript 컨벤션](#typescript-컨벤션) · [에이전트 메모리](#에이전트-메모리-agent_memories) ·
+[테스트 컨벤션](#테스트-컨벤션) · [브랜치 전략](#브랜치-전략) · [커밋 메시지](#커밋-메시지) ·
+[`gh` CLI](#github-리모트-작업은-gh-cli) · [PR/병합 규칙](#pr병합-규칙) · [릴리스](#릴리스) ·
+[주의사항](#주의사항)
+
+## 프로젝트 개요
+
+- **pal-crawl**: npm에 배포되는 TypeScript **라이브러리** (Node.js CLI/서버 아님).
+- 대상 사이트 3곳 크롤링:
+  - 국회입법예고 `pal.assembly.go.kr` (PalCrawl / PalParser)
+  - 국민참여입법센터 `opinion.lawmaking.go.kr` (NsmLmSts / NsmLmStsParser)
+  - 국회 의안정보시스템 `likms.assembly.go.kr` (LikmsCrawler — 제안이유 보정용)
+- 배포 산출물은 `dist/`만 (`.npmignore`가 `src/`·`agent_memories/` 제외).
+  gitignore 대상은 빌드 산출물·커버리지뿐 아니라 OS/에디터 파일과 에이전트 상태 파일(`.freebuff/` 등)까지 포함한다 (`.gitignore` 참조).
+
+## 저장소 구조
+
+```
+src/
+  index.ts        # public API barrel — 모든 외부 노출 export는 여기에 등록
+  config.ts       # Config enum: 도메인/URL/User-Agent 등 상수
+  http-client.ts  # HttpClient: 인코딩(cp949/euc-kr 폴백), 재시도, 타임아웃
+  parser.ts       # PalParser, NsmLmStsParser + 데이터 인터페이스 (HTML → 객체)
+  pal.ts          # PalCrawl, NsmLmSts, ScreenshotBase + 설정 인터페이스
+  likms.ts        # LikmsCrawler
+  *.test.ts       # 테스트는 소스와 동봉 (별도 test/ 디렉터리 없음)
+agent_memories/    # 에이전트 공유 메모리 (README.md = 형식 규칙, INDEX.md = 진입점)
+.github/workflows/  # test.yml, build.yml (Node 24, PR → main에서 실행)
+```
+
+**설계 원칙**: 네트워크 담당(크롤러 클래스)과 HTML 파싱 담당(파서 클래스)을 분리한다.
+새 사이트를 붙일 때도 `XxxCrawler`(요청) + `XxxParser`(파싱)로 나누고, 스크린샷은
+`ScreenshotBase`를 상속해 공유한다.
+
+## 개발 명령어
+
+```bash
+npm ci                # 설치 (lockfile 유지, npm install 금지)
+npm run typecheck     # tsc --noEmit
+npm run lint          # eslint "src/**/*.ts" --fix  (--fix가 기본 포함)
+npm run format        # prettier --write "src/**/*.ts"
+npm test              # jest
+npm run test:cov      # 커버리지
+npm run build         # tsc → dist/
+```
+
+**커밋/PR 전 필수 게이트**: `npm run typecheck && npm run lint && npm test && npm run build`.
+(`prepublishOnly`는 lint → test → build — `npm run build`(tsc)가 타입 오류에서 실패하므로 사실상 typecheck까지 포함된다.)
+
+## TypeScript 컨벤션
+
+### 툴체인
+
+- 대상: CommonJS / ES2020, `declaration: true`, `rootDir: src` → `outDir: dist`.
+- 포맷팅: Prettier — `singleQuote: true`, `trailingComma: "all"`, 2스페이스 들여쓰기, 80컬럼.
+- Lint: flat config(`@eslint/js` recommended + `typescript-eslint` recommended).
+  타입체크 기반 규칙은 없으므로 `npm run typecheck`가 사실상 타입 게이트.
+- 아래 규칙 중 린트로 강제되지 않는 항목(타입 단언·비동기 관례·null 정책)이 있다.
+  게이트 통과만으로 충분하지 않으므로 코드도 규칙을 따를 것.
+- `npm run lint`는 `--fix`가 기본 — 실행 후 달라진 파일을 확인하고 커밋에 포함.
+
+### 명명
+
+- 파싱 결과/데이터 인터페이스는 **`I` 접두사**: `ITableData`, `IContentData`, `ISearchQuery`, `INsmBillDetail`.
+- 클래스 설정/옵션 타입은 **접두사 없음**: `PalCrawlConfig`, `HttpClientConfig`, `LikmsCrawlerConfig`, `ScreenshotOptions`.
+- 클래스는 PascalCase, 메서드/필드는 camelCase. 상수는 `Config` enum으로 모은다(파일마다 상수를 흩어놓지 않음).
+- **파일명은 kebab-case**: `http-client.ts`, `likms.ts`. 테스트는 `원본이름.test.ts` (`likms.test.ts`).
+- 메서드/함수는 동사 시작 + 역할 접미사로 짓는다:
+  `get*`(요청), `parse*`(HTML → 객체), `build*`(URL·파라미터), `extract*`(특정 값 추출),
+  `hydrate*`(보정), `normalize*`(정규화), `init*`(초기화).
+- boolean은 의미가 드러나는 이름 (`enabled`, `fullPage`, `hydrateTruncatedTitles`).
+  축약은 `id`, `url`, `html`, `pdf`, `hwp` 등 이미 관용인 것만 허용.
+
+### 타입 시스템
+
+- **`any` 금지** (ESLint `@typescript-eslint/no-explicit-any` 위반). 외부 입력은
+  `unknown`으로 받고 가드로 좁힌다:
+  ```ts
+  // ❌ const parsed: any = JSON.parse(raw);
+  // ✅
+  const parsed: unknown = JSON.parse(raw);
+  if (typeof parsed !== 'object' || parsed === null) {
+    throw new Error('invalid payload');
+  }
+  ```
+- **데이터 구조는 `interface`, 닫힌 집합·유틸리티는 `type`**:
+  ```ts
+  interface IContentData { /* ... */ }       // 구조 → interface
+  type SortGbn = 'DESC' | 'ASC';             // 닫힌 집합 → type
+  ```
+  근거: `sortGbn?: 'DESC' | 'ASC'`, `format?: 'png' | 'jpeg'` 같은 기존 패턴.
+- **공개 멤버·함수는 반환 타입을 항상 명시**:
+  `public async getDetailPageHTML(billId: string): Promise<string>`.
+- 제네릭 타입 매개변수는 `T` 접두사 (`TItem`, `TResult`). 추론 가능한 곳에
+  불필요하게 제네릭·호출 위치 타입을 강제하지 않는다.
+- 선택 옵션은 `?`로 선언하고 메서드 진입부에서 `?? 기본값`으로 정규화
+  (LikmsCrawler/HttpClient 패턴):
+  ```ts
+  timeout: config?.timeout ?? 10000,
+  ```
+- 타입 단언(`as`)은 최소한만 — 검증 없이 타입을 확신시키는 단언 금지.
+  예외: 테스트의 httpClient mock 캐스팅 (테스트 컨벤션 참고).
+- 방어는 optional chaining과 병합 연산자로: `metaMatch?.[1]`, `contentType ?? ''`.
+
+### 값·결측 처리
+
+- 파싱 결측값은 **`undefined`가 아니라 `null`**: `string | null`, `number | null`.
+- 설정 옵션 미지정은 `undefined`(선택 `?`)로 표현하고 `??`로 처리 —
+  `null`과 `undefined`를 의미 없이 섞지 않는다.
+- 원시 문자열을 그대로 반환하지 말고 필요한 정규화(`trim`, 공백 정리)를 거친다.
+
+### 오류 처리
+
+- 필수 인자는 메서드 진입부에서 가드:
+  ```ts
+  if (!normalized) throw new Error('billNo is required');
+  ```
+- **파서(`PalParser`, `NsmLmStsParser`)는 절대 예외를 던지지 않는다.**
+  잘못된/빈 HTML이면 빈 배열·`null`·0으로 반환한다 (`returns [] for invalid html` 규약).
+- 네트워크 오류·재시도·타임아웃은 `HttpClient`의 책임. 파서와 매핑 계층까지 전파하지 않는다.
+- **선택적 보정(hydration) 로직은 절대 예외를 던지지 않는다.** 보정 실패 시 기존
+  값을 유지하고 조용히 넘어감 (`catch { /* 기존 값 유지 */ }`). 사용자 데이터 손실 금지.
+- catch 바인딩 값은 `unknown`으로 취급 — 가드 없이 사용하거나 무시하지 않는다.
+  빈 catch는 위 hydration 규칙이 적용되는 선택적 보정에서만 허용.
+- 오류 메시지는 영문 한 줄로 무엇이 잘못됐는지 설명 (`'billNo is required'`).
+  원본 오류를 감쌀 때는 맥락과 원문을 함께 남긴다.
+
+### 비동기 처리
+
+- `async/await`만 사용, raw `.then()` 체이닝 금지.
+- 모든 Promise는 `await`하거나 명시적으로 실패를 처리한다 —
+  floating promise 금지 (이 규칙은 린트로 강제되지 않으므로 특히 주의).
+- 독립적인 요청은 `Promise.all`로 병렬화, 일부 실패를 허용해야 하면
+  `Promise.allSettled`.
+- **외부 사이트 요청은 기본적으로 순서대로.** 폭주 방지는 `IBulkOptions`의
+  `delayMs` / `concurrency`로 조절하고 서버에 부하를 주는 기본값을 만들지 않는다.
+
+### 문서·주석 동기화
+
+- `src/`에서 `console.*` 사용 금지 (테스트 파일 제외).
+- JSDoc/주석은 **한국어**로 public API와 사이트 특이사항(숨김 폼, AJAX 엔드포인트 등)을 설명.
+  이유: 대상 사이트가 국내 정부 시스템이라 도메인 맥락이 곧 문서.
+  public 메서드는 1줄 한국어 요약 + 필요 시 `@param` / `@returns`.
+- import는 `import type { ... }`로 타입만 필요한 경우 분리, 상대경로에 확장자 없음.
+  Node 내장은 `'url'`, `'https'` 형태로 임포트.
+- **새 public API는 반드시 `src/index.ts`에 export 등록** (누출 방지),
+  같은 PR에서 README.md의 메서드·타입 문서도 갱신한다.
+
+## 에이전트 메모리 (`agent_memories/`)
+
+여러 에이전트/세션이 **동일한 기억**을 읽고 쓰기 위한 공유 기록소.
+형식의 단일 진실원은 `agent_memories/README.md`이며, 요약은 다음과 같다.
+
+- **진입점**: `agent_memories/INDEX.md` — 작업 시작 시 먼저 확인.
+- **유형별 폴더**: `decisions/`(결정과 이유), `tasks/`(작업 이력),
+  `site-notes/`(대상 사이트 DOM·엔드포인트 변화), `findings/`(버그·원인 분석).
+- **레코드 형식**: 파일당 1주제, 파일명 `YYYY-MM-DD-<영문-kebab-slug>.md`, YAML frontmatter 필수
+  (`id`, `type`, `title`, `status`, `author`, `created`, `updated`, `tags`).
+- **append-only**: 기존 레코드 본문을 고치지 않는다. 내용이 바뀌면 새 레코드를 만들고
+  `supersedes`로 연결한 뒤 이전 레코드는 `status: superseded`로 표시.
+- **쓰기 후 반드시 `INDEX.md` 갱신** (같은 작업 안에서).
+- 기록 대상: 커밋하기 어려운 결정과 근거, 사이트 구조 변화, 재현된 버그 원인,
+  되풀이되는 작업의 체크포인트. 매사 기록하지 말고 후속 에이전트가 물어볼 내용만.
+- **중복 금지**: 규칙으로 확정된 사항은 AGENTS.md로 승격하고 메모리에는 배경·근거만 남긴다.
+- **충돌 시 우선순위**: 지침(AGENTS.md)과 메모리 내용이 충돌하면 **AGENTS.md가 우선**한다 —
+  메모리는 규칙이 아니라 사실·배경 기록이다. 메모리가 사실이 바뀌어 정정되면
+  supersede 방식(새 레코드 + `supersedes` 연결)으로 갱신한다.
+- 비밀·토큰·개인정보 기록 금지. git에 커밋해 공유하고, npm 게시는 제외(`.npmignore`).
+
+## 테스트 컨벤션
+
+- 위치: `src/<파일명>.test.ts` (소스 옆). `testMatch: **/*.test.ts`, ts-jest.
+- 구조: `describe('클래스명')` → `describe('메서드명')` → `test('동작 설명', ...)`.
+- 테스트 이름은 **영문**, 동사 시작, 동작 기술 (`returns [] for invalid html`).
+- HTML fixture는 테스트 파일 상단에 템플릿 리터럴 상수로 인라인하고
+  `// ─── 섹션명 ───` 주석으로 구분한다. (실제 캡처를 축약한 형태)
+- 네트워크는 절대 호출하지 않는다. httpClient 주입 후 캐스팅해 mock:
+  ```ts
+  const httpClient = (instance as unknown as {
+    httpClient: { get: (url: URL) => Promise<string> };
+  }).httpClient;
+  jest.spyOn(httpClient, 'get').mockImplementation(async () => FIXTURE_HTML);
+  ```
+- 파서 변경 시 관련 fixture 테스트를 먼저 깨뜨려 회귀를 잡을 것 (대상 사이트 DOM 변경에 매우 민감).
+
+## 브랜치 전략
+
+| 브랜치 | 역할 |
+|--------|------|
+| `dev` | **로컬 작업 공간의 기본 시작점·복귀지.** 피처 브랜치 파생 기준. Renovate의 `baseBranches` |
+| `main` | 공식 브랜치 (origin HEAD). **피처 병합 대상.** CI는 **PR → main**에서만 트리거됨 |
+| `renovate/*` | Renovate 자동 생성 (`renovate/<scope>-<version>`, 예: `renovate/typescript-6.x`) |
+
+**로컬 작업 라이프사이클** (`dev`가 기본 시작점):
+
+1. **시작**: `git switch dev && git pull` — 작업은 항상 최신 `dev`에서 시작한다.
+2. **파생**: `git switch -c feat/<요약>` — 피처 브랜치는 `dev`에서 파생한다.
+3. **병합**: 작업 완료 후 PR로 **`main`에 병합**한다 (CI가 PR→main 전용이므로 병합 대상도 main).
+   `gh pr create --base main` → `gh pr merge <n> --merge`.
+4. **복귀·동기화**: `main` 병합이 끝나면 **`dev`로 복귀해 동기화**하고 다음 작업을 시작한다:
+
+   ```bash
+   git switch dev && git pull
+   git merge main --no-edit   # main에 병합된 내용을 dev에 반영
+   git push origin dev        # 리모트 dev도 같은 상태로 유지
+   ```
+
+- 기능/수정 브랜치 명명은 Conventional Commits 타입을 따름:
+  `feat/<요약>`, `fix/<요약>`, `chore/<요약>` (예: `feat/hydrate-likms-reason`).
+  요약은 영문 kebab-case.
+- `pull.rebase = false` — 히스토리는 rebase가 아니라 **merge**로 유지.
+
+## 커밋 메시지
+
+Conventional Commits, 영문 주제문:
+
+```
+feat: Hydrate empty proposalReason from 국회 의안정보시스템 (likms)
+fix: Preserve line breaks in proposalReason
+chore(deps): update all dependencies to latest compatible versions
+refactor: Use typed httpClient for mocking in NsmLmSts tests
+```
+
+- 사용 타입: `feat`, `fix`, `chore`, `chore(deps)`, `refactor`, `docs`, `test`, `build`.
+- 소콜론 뒤는 대문자 시작. 한국어 도메인 용어(의안정보시스템 등)는 그대로 허용.
+- 버전 커밋(`2.2.0` 형식의 bare version)은 `npm version`이 자동 생성 — 직접 작성하지 않음.
+- **커밋 서명**: Git에 PGP(GPG) 서명키가 설정되어 있으면 **커밋을 서명한다**.
+  - 설정 여부 확인: `git config --get commit.gpgsign` / `git config --get user.signingkey`
+    (서명키가 있는데 `commit.gpgsign`이 꺼져 있으면 `git commit -S`로 서명하거나
+    `git config commit.gpgsign true`로 기본값으로 활성화)
+  - 서명키가 없는 환경에서는 서명 없이 커밋해도 된다 — 키 생성을 강제하지 않는다.
+  - `npm version`이 만드는 버전 커밋도 같은 설정을 따라 자동 서명된다.
+
+## GitHub 리모트 작업은 `gh` CLI
+
+에이전트가 작업하든 커맨드라인에서 작업하든, GitHub 리모트 관련 작업은
+반드시 **GitHub CLI(`gh`)** 를 사용한다. 웹 UI 수작업이나 `git` 명령만으로
+우회하지 않는 것을 원칙으로 함.
+
+```bash
+gh auth status                 # 인증 상태 확인 (실패 시 안내부터)
+gh pr create --base main       # PR 생성 (피처 병합 대상은 main)
+gh pr view 123                 # PR 조회 (상태/체크/리뷰)
+gh pr checks --watch           # CI 결과 확인
+gh pr merge 123 --merge        # merge commit으로 병합 (squash 금지, 아래 규칙)
+gh pr list / gh issue list     # 목록 조회
+gh api ...                      # 없는 API는 gh api로 직접 호출
+```
+
+- `gh`가 없거나 미인증이면 작업을 멈추고 사용자에게 설치/인증을 안내할 것
+  (자동 로그인 시도나 토큰 입력 요청 금지).
+- 리모트 푸시·PR·이슈·릴리스 등 모든 원격 조작은 `gh` + `git` 조합으로 수행.
+
+## PR/병합 규칙
+
+1. **병합 방식은 merge commit** (squash 금지). 제목은 GitHub 기본 형식을 따른다:
+   `Merge pull request #N from vientorepublic/<branch>`.
+2. PR 전 게이트를 로컬에서 통과시키고 올린다:
+   `npm run typecheck && npm run lint && npm test && npm run build`.
+   ⚠️ CI workflow는 `pull_request: branches: [main]` 전용 — main 대상 PR은 CI가 도우며
+   **dev 대상 PR(현재 사실상 Renovate)은 CI가 돌지 않는다.** 어느 쪽이든 로컬 게이트는
+   병합 전 필수이고, dev 대상 PR에서는 로컬 검증이 유일한 방어선이므로 생략 금지.
+3. PR 본문에 변경 유형(feat/fix/…)과 영향받는 사이트/파서를 명시.
+4. Renovate PR: 자동 브랜치이며 베이스는 `dev` (renovate.json 설정 — 피처는 main이 대상이어도 Renovate만 dev는 유지).
+   병합 후 dev 동기화 루틴에서 함께 최신화하며, 의존성 업데이트는 Renovate에 맡긴다 —
+   수동으로 `package.json`을 올리지 않는 것을 원칙으로 함 (잠금파일 함께 커밋).
+5. 하나의 PR은 하나의 목적. 파서 로직 변경과 리팩터링/포맷팅을 섞지 않는다.
+
+## 릴리스
+
+### 배포 지시 절차
+
+사용자가 **배포**를 지시하면 아래 순서를 따른다. 각 단계의 성공을 확인한 뒤 다음 단계로 진행한다.
+
+1. **버전 분석 후 버전 범프** — 직전 태그 이후의 변경으로 major/minor/patch를 판단한다:
+
+   ```bash
+   git log $(git describe --tags --abbrev=0)..HEAD --oneline
+   ```
+
+   - `fix:` / `chore:`만 있으면 **patch**, `feat:` (하위 호환 유지)는 **minor**,
+     공개 API 제거·시그니처 변경 등 기존 사용자 코드가 깨지는 변경은 **major**.
+   - 판단 근거(어떤 타입의 커밋이 포함됐는지)를 PR 본문에 남긴다.
+   - `npm version <major|minor|patch>`로 범프 — `package.json` 버전 커밋(예: `2.3.0`)과
+     태그(`v2.3.0`)가 기존 패턴대로 자동 생성된다. 버전을 직접 편집해 태그를 별도로 만드는 방식은 쓰지 않는다.
+   - 브랜치는 `dev`에서 파생한 `chore/release-v2.3.0` 형태 (브랜치 전략의 라이프사이클).
+2. **lockfile 동기화** — `npm install`을 1회 실행해 `package-lock.json`이 새 버전과
+   일치하는지 확정하고 함께 커밋한다. (`npm version`이 이미 동기화했다면 차이 없음.)
+   ※ 개발 명령어의 "`npm install` 금지"는 **설치** 목적 규칙이고, 여기는 lockfile **갱신** 목적이므로 예외다.
+3. **PR 생성 (`gh`)**
+
+   ```bash
+   git push -u origin chore/release-v2.3.0
+   gh pr create --base main --title "chore: Release v2.3.0" --body "..."
+   ```
+
+   - PR 본문에 버전 판단 근거와 변경 요약을 포함한다 (PR/병합 규칙 3번 참조).
+4. **최종 검토 후 병합** — 아래를 전부 통과하고 문제가 없으면 병합한다:
+   - 로컬 게이트: **PR/병합 규칙 2번과 동일** — `npm run typecheck && npm run lint && npm test && npm run build`
+   - 형식: `npm run format` 실행 후 달라진 파일을 커밋에 포함
+   - GitHub CI/Checks: `gh pr checks --watch` 로 Test/Build 워크플로 성공 확인
+   - PR diff 최종 리뷰 (버전·lockfile 외에 불필요한 변경이 섞이지 않았는지)
+   - 문제가 있으면 병합하지 말고 수정한 뒤 이 단계를 다시 돈다.
+
+   ```bash
+   gh pr merge <n> --merge   # merge commit, squash 금지
+   ```
+
+5. **릴리스 생성** — 기존 GitHub 릴리즈 패턴과 일관된 구조로 만든다
+   (태그 `vX.Y.Z`, 제목 `release: vX.Y.Z`, 자동 노트):
+
+   ```bash
+   git switch main && git pull
+   git push origin --follow-tags                             # 버전 태그 푸시
+   gh release create vX.Y.Z --title "release: vX.Y.Z" --generate-notes
+   npm publish                                               # 게시 (prepublishOnly: lint → test → build)
+   ```
+
+   - `--generate-notes`가 기존처럼 `**Full Changelog**: .../compare/vA...vB` 비교 링크를 포함한다.
+   - 릴리스·게시가 끝나면 **`dev`로 복귀해 동기화**한다 (라이프사이클 4단계).
+
+### 기존 릴리스 스크립트 (같은 게이트 사용)
+
+```bash
+npm run release:patch   # npm version patch && npm publish
+npm run release:minor
+npm run release:major
+```
+
+- `prepack`이 clean → build를, `prepublishOnly`가 lint → test → build를 자동 실행.
+- 게시 전 `npm run release:dry`로 내용물 확인.
+- 다만 사용자가 배포를 지시한 경우에는 위 **배포 지시 절차**를 우선한다.
+
+## 주의사항
+
+- `http-client.ts`의 인코딩 폴백(UTF-8 선언 ↔ cp949 실제 응답) 로직은 사이트별
+  예외 대응이므로 임의로 제거하지 말 것.
+- Puppeteer 스크린샷은 선택 기능 (`screenshot` 설정). 기본 경로는 HTTP + cheerio 파싱이며
+  스크린샷 때문에 무거운 브라우저 의존을 기본 경로에 도입하지 말 것.
+- `.DS_Store` 등 로컬 파일과 에이전트 상태 파일(`.freebuff/` 등)은 커밋하지 않음 — `.gitignore` 패턴이 관리한다.

package/README.md

@@ -40,6 +40,7 @@
   - [getAllPages (NsmLmSts)](#getallpagesquery-options--asyncgeneratorinsmsearchresult)
   - [getAllPendingPages](#getallpendingpagesquery-options--asyncgeneratorinsmsearchresult)
   - [Screenshot (NsmLmSts)](#getnsmlisscreenshotquery--promisebuffer)
+- [LikmsCrawler - 국회 의안정보시스템 제안이유 조회](#likmscrawler---국회-의안정보시스템-제안이유-조회)
 - [Examples](#examples)
 - [License](#license)
 
@@ -73,6 +74,7 @@ interface PalCrawlConfig {
   customHeaders?: Record<string, string>; // 사용자 정의 헤더
   screenshot?: ScreenshotOptions; // 헤드리스 크로뮴 스크린샷 옵션
   hydrateTruncatedTitles?: boolean; // 잘린 제목 상세 조회 여부 (기본값: false)
+  hydrateProposalReason?: boolean; // 제안이유 빈 값일 때 의안정보시스템 보정 (기본값: true)
 }
 
 interface ScreenshotOptions {
@@ -151,6 +153,8 @@ interface IContentData {
 }
 ```
 
+PAL 상세 페이지에서 `proposalReason`이 비어 있는 의안이 있을 수 있습니다. 이때는 기본값(`hydrateProposalReason: true`)으로 국회 의안정보시스템(likms.assembly.go.kr)의 같은 의안에서 제안이유를 자동으로 보정합니다. 보정에 실패하더라도 기존 결과(`null`)를 그대로 유지하며 오류를 던지지 않습니다.
+
 `ISearchResult`는 검색/페이지 조회 결과를 나타내는 인터페이스입니다.
 
 ```typescript
@@ -765,6 +769,34 @@ try {
 
 ---
 
+## LikmsCrawler - 국회 의안정보시스템 제안이유 조회
+
+`LikmsCrawler`는 [국회 의안정보시스템](https://likms.assembly.go.kr)의 의안상세 페이지에서 제안이유 및 주요내용을 조회합니다. 의안상세 페이지는 심사정보 탭을 AJAX(POST)로 채우므로, 숨김 폼 파라미터를 추출해 `billInfo.do`에 POST한 뒤 `#prntSummary`에서 제안이유를 파싱합니다.
+
+PAL의 `contentId`(`PRC_...`)가 이 시스템의 `billId`와 동일하므로 그대로 전달할 수 있습니다.
+
+```typescript
+import { LikmsCrawler } from 'pal-crawl';
+
+const likms = new LikmsCrawler();
+
+// 제안이유 조회 (실패 시 null, 절대 예외를 던지지 않음)
+const reason = await likms.getProposalReason(
+  'PRC_G2G6E0D9E2Z3A1Y7Z5X1Y0W4E9E6D5',
+);
+console.log(reason);
+
+// 파싱만 수행하고 싶은 경우
+const fragmentHtml = await likms.getBillInfoHTML(
+  likms.parseDetailFormParams(await likms.getDetailPageHTML(billId)),
+);
+console.log(likms.parseProposalReason(fragmentHtml));
+```
+
+`PalCrawl`의 `getContent`/`getDoneContent`는 내부적으로 이 크롤러를 사용해 빈 `proposalReason`을 보정합니다(`hydrateProposalReason: false`로 비활성화 가능).
+
+---
+
 ## Examples
 
 ### 기본 사용법

package/dist/config.d.ts

@@ -6,5 +6,9 @@ export declare enum Config {
     DONE_CONTENT_URL = "/napal/lgsltpa/lgsltpaDone/view.do",
     UserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
     NSM_DOMAIN = "https://opinion.lawmaking.go.kr",
-    NSM_LIST_URL = "/gcom/nsmLmSts/out"
+    NSM_LIST_URL = "/gcom/nsmLmSts/out",
+    LIKMS_DOMAIN = "https://likms.assembly.go.kr",
+    LIKMS_DETAIL_PAGE_URL = "/bill/bi/billDetailPage.do",
+    LIKMS_BILL_INFO_URL = "/bill/bi/bill/detail/billInfo.do",
+    LIKMS_CURR_MENU_NO = "2600044"
 }

package/dist/config.js

@@ -12,5 +12,10 @@ var Config;
     // 국민참여입법센터 국회입법현황 (opinion.lawmaking.go.kr)
     Config["NSM_DOMAIN"] = "https://opinion.lawmaking.go.kr";
     Config["NSM_LIST_URL"] = "/gcom/nsmLmSts/out";
+    // 국회 의안정보시스템 (likms.assembly.go.kr)
+    Config["LIKMS_DOMAIN"] = "https://likms.assembly.go.kr";
+    Config["LIKMS_DETAIL_PAGE_URL"] = "/bill/bi/billDetailPage.do";
+    Config["LIKMS_BILL_INFO_URL"] = "/bill/bi/bill/detail/billInfo.do";
+    Config["LIKMS_CURR_MENU_NO"] = "2600044";
 })(Config || (exports.Config = Config = {}));
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAAA,IAAY,MAUX;AAVD,WAAY,MAAM;IAChB,+CAAqC,CAAA;IACrC,4DAAkD,CAAA;IAClD,+DAAqD,CAAA;IACrD,8DAAoD,CAAA;IACpD,iEAAuD,CAAA;IACvD,uIAA6H,CAAA;IAC7H,4CAA4C;IAC5C,wDAA8C,CAAA;IAC9C,6CAAmC,CAAA;AACrC,CAAC,EAVW,MAAM,sBAAN,MAAM,QAUjB"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAAA,IAAY,MAeX;AAfD,WAAY,MAAM;IAChB,+CAAqC,CAAA;IACrC,4DAAkD,CAAA;IAClD,+DAAqD,CAAA;IACrD,8DAAoD,CAAA;IACpD,iEAAuD,CAAA;IACvD,uIAA6H,CAAA;IAC7H,4CAA4C;IAC5C,wDAA8C,CAAA;IAC9C,6CAAmC,CAAA;IACnC,oCAAoC;IACpC,uDAA6C,CAAA;IAC7C,8DAAoD,CAAA;IACpD,kEAAwD,CAAA;IACxD,wCAA8B,CAAA;AAChC,CAAC,EAfW,MAAM,sBAAN,MAAM,QAejB"}

package/dist/http-client.d.ts

@@ -16,4 +16,10 @@ export declare class HttpClient {
     private decodeBody;
     private makeRequest;
     get(url: URL): Promise<string>;
+    /**
+     * URL-encoded 본문을 POST로 전송합니다.
+     * 국회 의안정보시스템의 일부 조각(_fragment) 엔드포인트는 GET이 아닌 POST만 허용합니다.
+     */
+    post(url: URL, body: string): Promise<string>;
+    private requestWithRetry;
 }

package/dist/http-client.js

@@ -100,17 +100,23 @@ class HttpClient {
         }
         return body.toString('utf8');
     }
-    async makeRequest(url) {
+    async makeRequest(url, method = 'GET', body) {
         return new Promise((resolve, reject) => {
             const headers = {
                 'User-Agent': this.userAgent,
                 ...this.customHeaders,
             };
+            if (method === 'POST' && body !== undefined) {
+                headers['Content-Type'] =
+                    'application/x-www-form-urlencoded; charset=UTF-8';
+                headers['Content-Length'] = String(Buffer.byteLength(body));
+            }
             const options = {
                 headers,
                 timeout: this.timeout,
+                method,
             };
-            const req = https.get(url, options, (res) => {
+            const req = https.request(url, options, (res) => {
                 if (res.statusCode && (res.statusCode < 200 || res.statusCode >= 300)) {
                     reject(new Error(`Invalid response: ${res.statusCode} ${res.statusMessage}`));
                     return;
@@ -120,8 +126,8 @@ class HttpClient {
                     chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
                 });
                 res.on('end', () => {
-                    const body = Buffer.concat(chunks);
-                    resolve(this.decodeBody(body, res.headers['content-type']));
+                    const responseBody = Buffer.concat(chunks);
+                    resolve(this.decodeBody(responseBody, res.headers['content-type']));
                 });
             });
             req.on('timeout', () => {
@@ -131,14 +137,28 @@ class HttpClient {
             req.on('error', (err) => {
                 reject(err);
             });
+            if (method === 'POST' && body !== undefined) {
+                req.write(body);
+            }
+            req.end();
             req.setTimeout(this.timeout);
         });
     }
     async get(url) {
+        return this.requestWithRetry(url, 'GET');
+    }
+    /**
+     * URL-encoded 본문을 POST로 전송합니다.
+     * 국회 의안정보시스템의 일부 조각(_fragment) 엔드포인트는 GET이 아닌 POST만 허용합니다.
+     */
+    async post(url, body) {
+        return this.requestWithRetry(url, 'POST', body);
+    }
+    async requestWithRetry(url, method, body) {
         let lastError;
         for (let attempt = 1; attempt <= this.retryCount; attempt++) {
             try {
-                return await this.makeRequest(url);
+                return await this.makeRequest(url, method, body);
             }
             catch (error) {
                 lastError = error;

package/dist/http-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { ScreenshotBase, PalCrawl, NsmLmSts, type ITableData, type IAttachment, type IContentData, type ISearchResult, type ISearchQuery, type IBulkOptions, type PalCrawlConfig, type ScreenshotOptions, type INsmSearchQuery, type INsmSearchResult, type INsmBillItem, type INsmBillDetail, type INsmAttachment, type NsmProgressStatus, type NsmProposerType, type NsmResolutionStatus, } from './pal';
 export { PalParser, NsmLmStsParser } from './parser';
+export { LikmsCrawler, type LikmsCrawlerConfig } from './likms';
 export { Config } from './config';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Config = exports.NsmLmStsParser = exports.PalParser = exports.NsmLmSts = exports.PalCrawl = exports.ScreenshotBase = void 0;
+exports.Config = exports.LikmsCrawler = exports.NsmLmStsParser = exports.PalParser = exports.NsmLmSts = exports.PalCrawl = exports.ScreenshotBase = void 0;
 var pal_1 = require("./pal");
 Object.defineProperty(exports, "ScreenshotBase", { enumerable: true, get: function () { return pal_1.ScreenshotBase; } });
 Object.defineProperty(exports, "PalCrawl", { enumerable: true, get: function () { return pal_1.PalCrawl; } });
@@ -8,6 +8,8 @@ Object.defineProperty(exports, "NsmLmSts", { enumerable: true, get: function ()
 var parser_1 = require("./parser");
 Object.defineProperty(exports, "PalParser", { enumerable: true, get: function () { return parser_1.PalParser; } });
 Object.defineProperty(exports, "NsmLmStsParser", { enumerable: true, get: function () { return parser_1.NsmLmStsParser; } });
+var likms_1 = require("./likms");
+Object.defineProperty(exports, "LikmsCrawler", { enumerable: true, get: function () { return likms_1.LikmsCrawler; } });
 var config_1 = require("./config");
 Object.defineProperty(exports, "Config", { enumerable: true, get: function () { return config_1.Config; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6BAoBe;AAnBb,qGAAA,cAAc,OAAA;AACd,+FAAA,QAAQ,OAAA;AACR,+FAAA,QAAQ,OAAA;AAkBV,mCAAqD;AAA5C,mGAAA,SAAS,OAAA;AAAE,wGAAA,cAAc,OAAA;AAClC,mCAAkC;AAAzB,gGAAA,MAAM,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6BAoBe;AAnBb,qGAAA,cAAc,OAAA;AACd,+FAAA,QAAQ,OAAA;AACR,+FAAA,QAAQ,OAAA;AAkBV,mCAAqD;AAA5C,mGAAA,SAAS,OAAA;AAAE,wGAAA,cAAc,OAAA;AAClC,iCAAgE;AAAvD,qGAAA,YAAY,OAAA;AACrB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA"}

package/dist/likms.d.ts

@@ -0,0 +1,45 @@
+export interface LikmsCrawlerConfig {
+    userAgent?: string;
+    timeout?: number;
+    retryCount?: number;
+    customHeaders?: Record<string, string>;
+}
+/**
+ * 국회 의안정보시스템(likms.assembly.go.kr) 크롤러.
+ *
+ * 의안상세 페이지(billDetailPage.do)는 심사정보 탭 내용을 빈 div에 AJAX(POST)로
+ * 채우므로, 정적 HTML만으로는 제안이유를 읽을 수 없다.
+ *
+ * 실제 흐름 (billDetail.js 기준):
+ *   1. GET  /bill/bi/billDetailPage.do?billId=...&currMenuNo=2600044
+ *      → 숨김 폼(#form)에 billId, billNo, billKindCd 등 파라미터 포함
+ *   2. POST /bill/bi/bill/detail/billInfo.do (폼 파라미터 직렬화)
+ *      → 심사정보 탭 조각 HTML 반환
+ *   3. 조각의 <pre id="prntSummary"> 안에 제안이유 및 주요내용이 들어 있음
+ *
+ * PAL(입법예고) 상세 페이지에서 제안이유가 비어 있는 의안의 contentId(=PRC_...)
+ * 는 동일한 ID로 이 시스템에서 조회할 수 있다.
+ */
+export declare class LikmsCrawler {
+    private readonly httpClient;
+    constructor(config?: LikmsCrawlerConfig);
+    private buildDetailPageUrl;
+    /** 의안상세 페이지 HTML을 반환합니다. */
+    getDetailPageHTML(billId: string): Promise<string>;
+    /**
+     * 의안상세 페이지의 숨김 폼(#form input[type=hidden]) 파라미터를 추출합니다.
+     * billInfo.do AJAX 요청은 이 파라미터들에 심사정보 섹션의 렌더링 조건이 걸려
+     * 있어 원본 페이지에서 그대로 가져와야 한다.
+     */
+    parseDetailFormParams(html: string): Record<string, string>;
+    /** 심사정보 탭 조각 HTML을 POST로 반환합니다. */
+    getBillInfoHTML(params: Record<string, string>): Promise<string>;
+    /** 심사정보 탭 조각 HTML에서 제안이유 및 주요내용을 파싱하여 반환합니다. */
+    parseProposalReason(fragmentHtml: string): string | null;
+    /**
+     * billId(PAL contentId와 동일)로 제안이유 및 주요내용을 조회합니다.
+     * 네트워크·파싱 실패를 절대 던지지 않고 null을 반환해 호출부가 안전하게
+     * 동작하도록 한다.
+     */
+    getProposalReason(billId: string): Promise<string | null>;
+}