saju8z 1.1.0 → 1.2.1

package/README.md

@@ -4,11 +4,13 @@
 
 양력/음력/윤달을 지원하고, 결과를 텍스트/JSON/AI 전달용 프롬프트로 출력합니다.
 
-**Node.js 22 이상과 npm**이 필요합니다. 터미널에서 바로 사용하려면 `--date`, `--time`을 본인의 생년월일시로 바꾸세요.
+터미널에서 바로 사용하려면 `--date`, `--time` 또는 `--dt`를 본인의 생년월일시로 입력하세요.
 
+**Node.js 22 이상과 npm**이 필요합니다. 
 
 
-## CLI 빠른 시작
+
+## 빠른 시작
 
 ### 바로 실행하고 결과 보기
 
@@ -25,7 +27,129 @@ npm install -g saju8z
 saju8z --date 2000-02-25 --time 04:10
 ```
 
+옵션 없이 `saju8z`를 실행하면 생년월일과 출생 시각을 cli에서 차례로 질문합니다. 
+
+```sh
+#실행 예시
+saju8z
+
+생년월일과 출생 시각을 입력하세요. 양력, 현재 GMT 시차로 계산합니다.
+생년월일 (YYYY-MM-DD, 예: 1998-03-05): 1998-03-05
+출생 시각 (HH:mm, 예: 11:00 / 시간을 모르면 비워두고 Enter): 11:00
+
+[만세력]
+...
+```
+
+- 날짜는 `1998-03-05`처럼 연도 4자리, 월 2자리, 일 2자리를 하이픈으로 구분합니다.
+- 시각은 `11:00`처럼 24시간제의 시, 분을 콜론으로 구분합니다. 오후 11시는 `23:00`, 자정은 `00:00`입니다.
+- 시간을 모르면 시각 질문에서 아무것도 적지 않고 Enter를 누르세요.
+- 시간을 입력하면 **양력, 실행 환경의 현재 GMT 시차, 기본 텍스트 형식**으로 사주를 출력합니다. 시간을 생략하면 양력 날짜 기준으로 계산하며 GMT 환산과 -30분 보정은 생략합니다.
+- 잘못된 날짜, 시각이나 빈 날짜는 오류로 종료합니다. 빈 시각은 시간 미상으로 처리합니다. 다시 실행해 입력하세요. 음력, 윤달, 고정 시차, 다른 출력 형식은 아래 CLI 옵션을 사용하세요.
+
+대화형 입력은 **인자가 전혀 없을 때만** 시작합니다. 옵션을 전달하면 `--date` 또는 `--dt`가 필요하며, `--time`은 선택입니다. 입력 안내는 표준 오류(stderr), 계산 결과는 표준 출력(stdout)에 기록합니다.
+
+
+
+### 날짜와 시각을 한 번에 입력하기
+
+`--dt`는 날짜만 적는 **`YYYYMMDD` 8자리**와 시각까지 적는 **`YYYYMMDDHHmm` 12자리**를 지원합니다. `19980305`는 `--date 1998-03-05`와 같으며 시간없는 사주를 출력합니다. `199803051100`은 `--date 1998-03-05 --time 11:00`과 같은 사주를 출력합니다.
+
+```sh
+saju8z --dt 19980305
+saju8z --dt 199803051100
+saju8z --dt 199803051100 --gmt +09:00 --format json
+saju8z --dt=199803051100 --gmt +09:00 --format prompt
+```
+
+**옵션으로 실행할 때는 `--date` 또는 `--dt`를 입력해야 합니다. `--time`은 선택입니다.** `--dt`와 `--date`, `--time`을 혼용하면 오류가 발생합니다. 월, 일, 시, 분은 각각 두 자리로 입력하며, 날짜와 시각의 유효성 검사는 기존 입력 방식과 같습니다. 시간이 있으면 `--gmt` 생략 시 현재 시차를 사용합니다. 시간이 없으면 시차 환산을 생략합니다. `--calendar lunar` (음력), `--leap` (윤달)은 두 방식 모두 사용할 수 있습니다.
+
+### 시간을 모를 때 시간없는 사주 출력
+
+```sh
+saju8z --date 1998-03-05
+saju8z --dt 19980305
+```
+
+위 두 명령은 동일한 시간없는 사주 결과를 반환합니다.
+
+```text
+
+[만세력]
+양력 날짜: 1998-03-05
+출생 시각: 미상 (시간없는 사주만 제공하며 시주는 추정하거나 해석하지 않습니다.)
+시간 미상으로 GMT 환산과 -30분 보정은 적용하지 않았습니다.
+일간: 신금(辛金)
+
+년주: 무인(戊寅)
+- 천간: 무(戊), 토(土), 정인
+- 지지: 인(寅), 목(木), 정재
+
+월주: 갑인(甲寅)
+- 천간: 갑(甲), 목(木), 정재
+- 지지: 인(寅), 목(木), 정재
+
+일주: 신해(辛亥)
+- 천간: 신(辛), 금(金), 본원
+- 지지: 해(亥), 수(水), 상관
+```
+
+시각이 없으면 입력 날짜를 그대로 사용합니다. 음력 입력은 양력으로 변환한 날짜를 사용합니다.  
+입춘, 절입 당일부터 새 년주, 월주를 적용합니다.
+
+```sh
+saju8z --dt 19980305 --format json
+```
+
+<details>
+<summary>시간 미상 JSON 결과 펼치기</summary>
+
+```json
+{
+  "normalizedDateTime": {
+    "year": 1998,
+    "month": 3,
+    "day": 5,
+    "hour": null,
+    "minute": null
+  },
+  "calculationDateTime": {
+    "year": 1998,
+    "month": 3,
+    "day": 5,
+    "hour": null,
+    "minute": null
+  },
+  "fourPillars": {
+    "year": {
+      "stem": "무",
+      "branch": "인"
+    },
+    "month": {
+      "stem": "갑",
+      "branch": "인"
+    },
+    "day": {
+      "stem": "신",
+      "branch": "해"
+    },
+    "hour": null
+  },
+  "tenGods": {
+    "yearStem": "정인",
+    "yearBranch": "정재",
+    "monthStem": "정재",
+    "monthBranch": "정재",
+    "dayBranch": "상관",
+    "hourStem": null,
+    "hourBranch": null
+  }
+}
+```
+
+</details>
 
+시간 미상 결과는 `fourPillars.hour`, `tenGods.hourStem`, `tenGods.hourBranch`가 `null`이며, `normalizedDateTime`, `calculationDateTime`의 `hour`, `minute`도 `null`입니다. 두 날짜 객체는 같은 양력 날짜를 담습니다. 텍스트, 프롬프트에는 년주, 월주, 일주만 표시하고, 프롬프트에는 시주를 추정하거나 해석하지 않도록 안내합니다.
 
 ### 출력 형식 선택
 
@@ -33,7 +157,7 @@ saju8z --date 2000-02-25 --time 04:10
 | 옵션                | 결과                       |
 | ----------------- | ------------------------ |
 | `--format text`   | 만세력 텍스트 (기본값)            |
-| `--format json`   | 환산·계산 시각, 사주팔자, 십성의 JSON |
+| `--format json`   | 환산, 계산 시각, 사주팔자, 십성의 JSON |
 | `--format prompt` | AI 전달용 프롬프트 텍스트          |
 
 
@@ -42,14 +166,9 @@ saju8z --date 2000-02-25 --time 04:10
 ### 만세력 텍스트 출력:
 
 ```text
-2000-02-25 04:10
-```
-
+saju8z --dt 200002250410
 
 
-&nbsp;
-
-```text
 [만세력]
 양력 환산 시각: 2000-02-25 04:10 (GMT+09:00)
 -30분 보정 후 계산 시각: 2000-02-25 03:40
@@ -77,7 +196,7 @@ saju8z --date 2000-02-25 --time 04:10
 **JSON 출력:**
 
 ```sh
-npx --yes saju8z --date 2000-02-29 --time 00:10 --gmt +09:00 --format json
+saju8z --date 2000-02-29 --time 00:10 --gmt +09:00 --format json
 ```
 
 <details class="orca-details">
@@ -136,7 +255,7 @@ npx --yes saju8z --date 2000-02-29 --time 00:10 --gmt +09:00 --format json
 **AI 전달용 프롬프트 출력:**
 
 ```sh
-npx --yes saju8z --date 2000-02-29 --time 00:10 --gmt +09:00 --format prompt
+saju8z --date 2000-02-29 --time 00:10 --gmt +09:00 --format prompt
 ```
 
 해석 지침 사이에 만세력 계산 결과가 들어갑니다. 생성한 출력 전체를 AI 대화창에 붙여 넣어 사용합니다. 
@@ -185,7 +304,7 @@ CLI 자체는 AI를 호출하거나 해석을 생성하지 않습니다.
 - 사주 용어를 사용하지 마라.
 - 성격이나 미래를 단정하지 말고 가능한 경향으로 표현해라.
 - 10살짜리도 이해할 수 있도록 쉽게 풀어서 설명해라.
-- 제공되지 않은 대운·세운·지장간 등의 계산 결과를 만들어내지 마라.
+- 제공되지 않은 대운, 세운, 지장간 등의 계산 결과를 만들어내지 마라.
 - 정보가 부족한 질문에는 무엇이 더 필요한지 설명해라
 ```
 
@@ -210,10 +329,11 @@ npx --yes saju8z --date 2017-05-01 --time 12:00 --gmt +09:00 --calendar lunar --
 ### CLI 옵션과 시차
 
 
-| 옵션             | 필수  | 기본값·설명                                                |
+| 옵션             | 필수  | 기본값, 설명                                                |
 | -------------- | --- | ----------------------------------------------------- |
-| `--date`       | 예   | 생년월일 `YYYY-MM-DD`. 월·일은 두 자리                          |
-| `--time`       | 예   | 출생 시각 `HH:mm`, `00:00`\~`23:59`. 초는 지원하지 않음           |
+| `--dt`         | 선택 | 날짜 `YYYYMMDD` 8자리 또는 날짜, 시각 `YYYYMMDDHHmm` 12자리 |
+| `--date`       | 조건부 | 생년월일 `YYYY-MM-DD`. 옵션 실행 시 `--dt`가 없으면 필수                          |
+| `--time`       | 아니요 | 출생 시각 `HH:mm`, `00:00`\~`23:59`. 생략하면 시간없는 사주 출력 |
 | `--gmt`        | 아니요 | 고정 시차 `±HH:mm`, `-12:00`\~`+14:00` 기본값은 실행 환경의 현재 GMT |
 | `--calendar`   | 아니요 | `solar`(기본, 양력) 또는 `lunar`(한국 음력)                     |
 | `--leap`       | 아니요 | 음력 윤달일 때 지정. `--calendar lunar`와 함께 사용                |
@@ -223,7 +343,10 @@ npx --yes saju8z --date 2017-05-01 --time 12:00 --gmt +09:00 --calendar lunar --
 
 시차는 `--gmt -05:00` 또는 `--gmt=-05:00`처럼 전달합니다.
 
-`--gmt`를 생략하면 출생일 당시가 아닌 **실행 시점의 GMT 시차**를 사용합니다. 한국 표준시 환경에서는 `+09:00`이며, 서머타임을 사용하는 환경에서는 현재 서머타임도 반영됩니다. 출생 당시 위치의 시차로 계산하려면 해당 시차를 직접 지정하세요.
+`--gmt`를 생략하면 출생일 당시가 아닌 **실행 시점의 GMT 시차**를 사용합니다.  
+한국 표준시 환경에서는 `+09:00`이며, 서머타임을 사용하는 환경에서는 현재 서머타임도 반영됩니다.  
+출생 당시 위치의 시차로 계산하려면 해당 시차를 직접 지정하세요.  
+시간 미상일 때는 `--gmt` 값에 관계없이 날짜 기준 사주를 계산합니다. 전달한 GMT 값의 형식과 범위는 계속 검증합니다.
 
 
 
@@ -247,6 +370,17 @@ console.log(formatSajuChart(result, "prompt")); // AI 전달용 프롬프트 문
 
 
 
+시간을 모르면 라이브러리에서도 `time`을 생략하거나 `undefined`로 전달합니다.
+
+```ts
+const unknown = calculateSajuChart({ date: "1998-03-05", gmt: "+09:00" });
+console.log(unknown.fourPillars.hour); // null
+console.log(unknown.normalizedDateTime.hour); // null
+console.log(formatSajuChart(unknown)); // 년, 월, 일 시간없는 사주
+```
+
+시간을 명시한 호출은 `SajuChartResultWithTime`, 생략한 호출은 `SajuChartResultWithoutTime`으로 추론됩니다. `SajuChartResult`는 두 결과의 유니온입니다. `time`이 선택적인 `SajuChartInput` 변수를 전달하면 결과도 유니온이므로 시주를 사용하기 전에 `null`을 확인하세요. 두 결과 타입은 `saju8z`와 `saju8z/format`에서 가져올 수 있습니다. 저수준 `saju8z/core`의 기존 사주 타입과 함수는 그대로 사용합니다.
+
 ## 입력
 
 `calculateSajuChart(input)`은 다음 객체를 받습니다.
@@ -255,13 +389,13 @@ console.log(formatSajuChart(result, "prompt")); // AI 전달용 프롬프트 문
 | 필드          | 타입                   | 필수  | 설명                                         |
 | ----------- | -------------------- | --- | ------------------------------------------ |
 | `date`      | `string`             | 예   | `YYYY-MM-DD`. 선택한 달력 기준의 날짜                |
-| `time`      | `string`             | 예   | `HH:mm`, `00:00`\~`23:59`. 초는 지원하지 않음      |
+| `time`      | `string`             | 아니요 | `HH:mm`, `00:00`\~`23:59`. 생략 또는 `undefined`이면 시간 미상 |
 | `gmt`       | `string`             | 예   | 부호를 포함한 고정 시차 `±HH:mm`, `-12:00`\~`+14:00` |
 | `calendar`  | `"solar"`, `"lunar"` | 아니요 | 양력 또는 한국 음력. 기본값 `"solar"`                 |
 | `leapMonth` | `boolean`            | 아니요 | 음력 윤달 여부. 기본값 `false`, 음력에서만 `true` 허용     |
 
 
-라이브러리 API의 `gmt`는 출생 당시 날짜·시간의 시차를 직접 지정합니다. 예를 들어 한국 표준시는 `+09:00`, UTC는 `+00:00`입니다. 실행 환경의 시간대나 지역 이름으로 자동 추정하지 않습니다.
+라이브러리 API의 `gmt`는 출생 당시 날짜, 시간의 시차를 직접 지정합니다. 예를 들어 한국 표준시는 `+09:00`, UTC는 `+00:00`입니다. 실행 환경의 시간대나 지역 이름으로 자동 추정하지 않습니다. `gmt`는 시간 미상 입력에서도 필수이며 형식을 검증하지만, 날짜 기준 계산에는 사용하지 않습니다. `time: ""`, `time: null`은 허용하지 않습니다. CLI에서도 `--time` 값을 비우는 대신 옵션을 생략하고, 대화형 질문에서만 빈 시각을 허용합니다.
 
 음력 윤달은 다음과 같이 입력합니다.
 
@@ -285,13 +419,13 @@ const result = calculateSajuChart({
 
 | 필드                    | 내용                                                                                                    |
 | --------------------- | ----------------------------------------------------------------------------------------------------- |
-| `normalizedDateTime`  | 양력으로 변환하고 GMT+09:00으로 환산한 `{ year, month, day, hour, minute }`                                        |
-| `calculationDateTime` | 환산 시각에 -30분 보정을 적용한 계산 시각                                                                             |
-| `fourPillars`         | `year`, `month`, `day`, `hour`의 사주팔자. 각 값은 `{ stem, branch }`                                         |
-| `tenGods`             | 일간 기준 십성. `yearStem`, `yearBranch`, `monthStem`, `monthBranch`, `dayBranch`, `hourStem`, `hourBranch` |
+| `normalizedDateTime`  | 시간이 있으면 GMT+09:00으로 환산한 양력 시각. 시간이 없으면 양력 날짜와 `hour: null`, `minute: null`                                        |
+| `calculationDateTime` | 시간이 있으면 -30분 보정한 시각. 시간이 없으면 `normalizedDateTime`과 동일한 날짜, null 시각                                                                             |
+| `fourPillars`         | `year`, `month`, `day`, `hour`의 사주팔자. 시간이 없으면 `hour: null`                                         |
+| `tenGods`             | 일간 기준 십성. `yearStem`, `yearBranch`, `monthStem`, `monthBranch`, `dayBranch`, `hourStem`, `hourBranch`. 시간 미상이면 마지막 두 필드는 `null` |
 
 
-천간·지지·십성은 `"병"`, `"진"`, `"식신"`과 같은 한국어 문자열입니다. 일간 자체의 십성 필드는 없으며, 만세력 텍스트에서는 `본원`으로 표시합니다.
+천간, 지지, 십성은 `"병"`, `"진"`, `"식신"`과 같은 한국어 문자열입니다. 일간 자체의 십성 필드는 없으며, 만세력 텍스트에서는 `본원`으로 표시합니다.
 
 
 
@@ -301,7 +435,7 @@ const result = calculateSajuChart({
 | 가져오기 경로         | 용도                                                                 |
 | --------------- | ------------------------------------------------------------------ |
 | `saju8z`        | `calculateSajuChart`, `formatSajuChart`, `UserInputError` 및 입출력 타입 |
-| `saju8z/core`   | 저수준 계산 함수, 상수, 간지·오행 데이터와 도메인 타입                                   |
+| `saju8z/core`   | 저수준 계산 함수, 상수, 간지, 오행 데이터와 도메인 타입                                   |
 | `saju8z/lunar`  | `lunarToSolar`, `lunarMonthDays`, `hasLunarLeapMonth`              |
 | `saju8z/format` | `formatSajuChart`, `SajuChartFormat`, `SajuChartResult` 타입         |
 
@@ -312,15 +446,19 @@ const result = calculateSajuChart({
 
 ## 계산 기준과 지원 범위
 
+시간을 입력한 경우 기존 계산 기준을 적용합니다.
+
 1. 음력이면 양력으로 변환합니다.
 2. 입력 GMT에서 GMT+09:00으로 환산합니다.
 3. -30분을 보정한 시각으로 사주팔자를 계산합니다.
 
-년주는 입춘, 월주는 프로젝트의 고정 절입 시각 표, 일주는 자정을 기준으로 합니다. 고정 절입 표는 실제 연도별 천문 절기 시각과 차이가 있을 수 있습니다. 서머타임·역사적 시차·출생지 경도 보정은 자동 적용하지 않습니다.
+시간을 생략한 경우 음력 변환만 수행하고, 시차 환산과 -30분 보정 없이 해당 양력 날짜로 시간없는 사주를 계산합니다. 입춘, 절입 당일부터 새 년주, 월주를 적용하고 일주는 입력 날짜 기준입니다. 임의의 자정, 정오를 출생 시각으로 대입하지 않습니다.
+
+시간을 입력한 경우 년주는 입춘, 월주는 프로젝트의 고정 절입 시각 표, 일주는 자정을 기준으로 합니다. 고정 절입 표는 실제 연도별 천문 절기 시각과 차이가 있을 수 있습니다. 서머타임, 역사적 시차, 출생지 경도 보정은 자동 적용하지 않습니다.
 
-양력 입력과 GMT+09:00 환산 날짜는 1900~2100년을 지원합니다. 음력은 1900년부터 음력 2050년 11월 18일까지의 유효 날짜를 지원합니다. -30분 보정으로 1900년 첫날이 전년 말로 이동할 수 있습니다.
+양력 입력과 GMT+09:00 환산 날짜는 1900~2100년을 지원합니다. 음력은 1900년부터 음력 2050년 11월 18일까지의 유효 날짜를 지원합니다. 시간을 입력하면 -30분 보정으로 1900년 첫날이 전년 말로 이동할 수 있습니다. 시간이 없으면 해당 날짜를 보존합니다.
 
-성별 입력은 필요하지 않습니다. 대운·세운·운세·성격 해석 기능은 제공하지 않습니다.
+성별 입력은 필요하지 않습니다. 대운, 세운, 운세, 성격 해석 기능은 제공하지 않습니다.
 
 
 
@@ -330,9 +468,9 @@ const result = calculateSajuChart({
 | 위치                         | 역할                            |
 | -------------------------- | ----------------------------- |
 | `src/input/`               | 입력 문자열 해석, 형식 검증, 사용자 입력 오류   |
-| `src/application/`         | 음력·시차 환산과 사주 계산 순서 조합         |
-| `src/calendar/`            | 날짜 산술, 음력 변환, 절기·태양시 보정       |
-| `src/saju/`, `src/domain/` | 사주·십성 계산 규칙, 타입과 기준 데이터       |
+| `src/application/`         | 음력, 시차 환산과 사주 계산 순서 조합         |
+| `src/calendar/`            | 날짜 산술, 음력 변환, 절기, 태양시 보정       |
+| `src/saju/`, `src/domain/` | 사주, 십성 계산 규칙, 타입과 기준 데이터       |
 | `src/output/`              | 만세력 텍스트 생성, 프롬프트 조립과 출력 형식 선택 |
 | `bin/`                     | CLI 옵션 해석과 표준 입출력             |
 | `test/`, `scripts/`        | 회귀 테스트, 빌드와 설치 패키지 검증         |
@@ -344,6 +482,6 @@ const result = calculateSajuChart({
 
 이 프로젝트는 [MIT 라이선스](LICENSE)로 배포합니다. Copyright (c) 2026 frogred8.
 
-상업적 사용·수정·재배포를 허용하며, 소프트웨어의 복사본이나 주요 부분에 저작권 및 라이선스 고지를 유지해야 합니다. 소프트웨어는 보증 없이 제공됩니다. 정확한 조건은 LICENSE 전문을 참고하세요.
+상업적 사용, 수정, 재배포를 허용하며, 소프트웨어의 복사본이나 주요 부분에 저작권 및 라이선스 고지를 유지해야 합니다. 소프트웨어는 보증 없이 제공됩니다. 정확한 조건은 LICENSE 전문을 참고하세요.
 
 번들에 포함된 `korean-lunar-calendar`의 원 저작권 및 MIT 라이선스 고지는 [THIRD-PARTY-LICENSES.txt](THIRD-PARTY-LICENSES.txt)에 별도로 보존합니다.

package/bin/saju8z.js

@@ -1,12 +1,22 @@
 #!/usr/bin/env node
 import process from "node:process";
+import { createInterface } from "node:readline";
 import { calculateSajuChart, formatSajuChart, UserInputError } from "../dist/index.js";
 
-const HELP_TEXT = `사용법: saju8z --date YYYY-MM-DD --time HH:mm [--gmt ±HH:mm] [옵션]
+const HELP_TEXT = `사용법: saju8z
+        saju8z --date YYYY-MM-DD [--time HH:mm] [--gmt ±HH:mm] [옵션]
+        saju8z --dt YYYYMMDD[HHmm] [--gmt ±HH:mm] [옵션]
 
-필수 입력:
+인자 없이 실행하면 날짜와 시각을 차례로 입력받습니다.
+  날짜 예: 1998-03-05 / 시각 예: 11:00 (24시간제, 모르면 비워두고 Enter)
+  대화형 입력은 양력·현재 GMT 시차·text 출력을 사용합니다.
+
+옵션으로 실행할 때 필수 입력 (둘 중 하나):
+  --dt         생년월일 8자리 (YYYYMMDD) 또는 생년월일시 12자리 (YYYYMMDDHHmm)
   --date       생년월일 (YYYY-MM-DD)
-  --time       출생 시각 (HH:mm, 00:00~23:59)
+  --time       출생 시각 (선택, HH:mm, 00:00~23:59). 생략하면 시간없는 사주만 계산
+  --date 또는 --dt는 필수이며, --dt와 --date·--time은 혼용할 수 없습니다.
+  시간이 없으면 입력 날짜 기준으로 시간없는 사주를 계산하고 GMT 환산·-30분 보정은 생략합니다.
 
 옵션:
   --gmt        고정 GMT 시차 (기본: 실행 환경의 현재 시차, -12:00~+14:00)
@@ -16,6 +26,9 @@ const HELP_TEXT = `사용법: saju8z --date YYYY-MM-DD --time HH:mm [--gmt ±HH:
   --help, -h   도움말
 
 예제:
+  saju8z
+  saju8z --dt 19980305
+  saju8z --dt 199803051100
   saju8z --date 2000-02-29 --time 00:10
   saju8z --date 2000-02-29 --time 00:10 --gmt +09:00
   saju8z --date 2000-02-29 --time 00:10 --gmt=-05:00 --format json
@@ -32,7 +45,35 @@ function getCurrentGmtOffset() {
   return `${sign}${hours}:${remainder}`;
 }
 
-const VALUE_OPTIONS = new Set(["--date", "--time", "--gmt", "--calendar", "--format"]);
+async function readInteractiveArguments() {
+  const reader = createInterface({
+    input: process.stdin,
+    output: process.stderr,
+    terminal: Boolean(process.stdin.isTTY && process.stderr.isTTY),
+    crlfDelay: Infinity
+  });
+  const answers = reader[Symbol.asyncIterator]();
+  /** @param {string} prompt */
+  async function ask(prompt) {
+    process.stderr.write(prompt);
+    const answer = await answers.next();
+    if (answer.done) {
+      throw new UserInputError("입력이 종료되었습니다. --date 또는 --dt를 사용하세요.");
+    }
+    return answer.value.trim();
+  }
+
+  try {
+    process.stderr.write("생년월일과 출생 시각을 입력하세요. 양력·현재 GMT 시차로 계산합니다.\n");
+    const date = await ask("생년월일 (YYYY-MM-DD, 예: 1998-03-05): ");
+    const time = await ask("출생 시각 (HH:mm, 예: 11:00 / 시간을 모르면 비워두고 Enter): ");
+    return time ? ["--date", date, "--time", time] : ["--date", date];
+  } finally {
+    reader.close();
+  }
+}
+
+const VALUE_OPTIONS = new Set(["--dt", "--date", "--time", "--gmt", "--calendar", "--format"]);
 
 /** @param {string[]} args */
 function parseOptions(args) {
@@ -57,12 +98,35 @@ function parseOptions(args) {
   return { values, leapMonth };
 }
 
+/** @param {Map<string, string>} values */
+function resolveDateTime(values) {
+  const dt = values.get("--dt");
+  if (dt !== undefined) {
+    if (values.has("--date") || values.has("--time")) {
+      throw new UserInputError("--dt는 --date 또는 --time과 함께 사용할 수 없습니다.");
+    }
+    if (![8, 12].includes(dt.length) || !/^\d+$/.test(dt)) {
+      throw new UserInputError(
+        "--dt는 YYYYMMDD 형식의 8자리 또는 YYYYMMDDHHmm 형식의 12자리 숫자여야 합니다."
+      );
+    }
+    return {
+      date: `${dt.slice(0, 4)}-${dt.slice(4, 6)}-${dt.slice(6, 8)}`,
+      ...(dt.length === 12 ? { time: `${dt.slice(8, 10)}:${dt.slice(10, 12)}` } : {})
+    };
+  }
+  const date = values.get("--date");
+  const time = values.get("--time");
+  if (!date) {
+    throw new UserInputError("--date 또는 --dt를 입력하세요.");
+  }
+  return { date, ...(time === undefined ? {} : { time }) };
+}
+
 /** @param {string[]} args */
 function parseArguments(args) {
   const { values, leapMonth } = parseOptions(args);
-  const date = values.get("--date");
-  const time = values.get("--time");
-  if (!date || !time) throw new UserInputError("--date, --time은 필수입니다.");
+  const { date, time } = resolveDateTime(values);
   const gmt = values.get("--gmt") ?? getCurrentGmtOffset();
   const calendar = values.get("--calendar") ?? "solar";
   if (calendar !== "solar" && calendar !== "lunar")
@@ -70,7 +134,10 @@ function parseArguments(args) {
   const format = values.get("--format") ?? "text";
   if (format !== "text" && format !== "json" && format !== "prompt")
     throw new UserInputError("출력 형식은 text, json 또는 prompt이어야 합니다.");
-  return { input: { date, time, gmt, calendar, leapMonth }, format };
+  return {
+    input: { date, ...(time === undefined ? {} : { time }), gmt, calendar, leapMonth },
+    format
+  };
 }
 
 try {
@@ -79,9 +146,11 @@ try {
   if (showHelp) {
     process.stdout.write(HELP_TEXT);
   } else {
-    const { input, format } = parseArguments(args);
+    const inputArgs = args.length === 0 ? await readInteractiveArguments() : args;
+    const { input, format } = parseArguments(inputArgs);
     const result = calculateSajuChart(input);
-    process.stdout.write(`${formatSajuChart(result, format)}\n`);
+    const leadingNewline = format === "text" ? "\n" : "";
+    process.stdout.write(`${leadingNewline}${formatSajuChart(result, format)}\n`);
   }
 } catch (error) {
   process.stderr.write(

package/dist/core.cjs

@@ -37,7 +37,9 @@ __export(core_exports, {
   addMinutes: () => addMinutes,
   applySolarTimeCorrection: () => applySolarTimeCorrection,
   branchIndex: () => branchIndex,
+  calculateDateTenGods: () => calculateDateTenGods,
   calculateDayPillar: () => calculateDayPillar,
+  calculateDayPillarFromDate: () => calculateDayPillarFromDate,
   calculateFourPillars: () => calculateFourPillars,
   calculateHourBranch: () => calculateHourBranch,
   calculateHourPillar: () => calculateHourPillar,
@@ -45,10 +47,12 @@ __export(core_exports, {
   calculateTenGod: () => calculateTenGod,
   calculateTenGods: () => calculateTenGods,
   calculateYearPillar: () => calculateYearPillar,
+  compareLocalDate: () => compareLocalDate,
   compareLocalDateTime: () => compareLocalDateTime,
   daysInMonth: () => daysInMonth,
   formatLocalDateTime: () => formatLocalDateTime,
   formatPillar: () => formatPillar,
+  getMonthBranchBySolarDate: () => getMonthBranchBySolarDate,
   getMonthBranchBySolarTerm: () => getMonthBranchBySolarTerm,
   getSolarTermDateTime: () => getSolarTermDateTime,
   hasLunarLeapMonth: () => hasLunarLeapMonth,
@@ -58,6 +62,7 @@ __export(core_exports, {
   lunarMonthDays: () => lunarMonthDays,
   lunarToSolar: () => lunarToSolar,
   monthBranchesInOrder: () => monthBranchesInOrder,
+  monthPillarFromBranch: () => monthPillarFromBranch,
   pillarFromIndex: () => pillarFromIndex,
   positiveModulo: () => positiveModulo,
   sexagenaryIndexOfPillar: () => sexagenaryIndexOfPillar,
@@ -74,7 +79,7 @@ var SUPPORTED_START_YEAR = 1900;
 var SUPPORTED_END_YEAR = 2100;
 
 // src/config/saju8z.ts
-var SAJU8Z_VERSION = "1.1.0";
+var SAJU8Z_VERSION = "1.2.1";
 var SAJU8Z_CALCULATION_PROFILE = "saju8z-fixed-gmt-kst-minus30-v1";
 var SAJU8Z_CORRECTION_MINUTES = -30;
 
@@ -229,43 +234,43 @@ function branchIndex(branch) {
 
 // src/domain/hanja.ts
 var STEM_HANJA = {
-  \uAC11: { hanja: "\u7532", reading: "\uAC11\uC637 \uAC11" },
-  \uC744: { hanja: "\u4E59", reading: "\uC0C8 \uC744" },
-  \uBCD1: { hanja: "\u4E19", reading: "\uB0A8\uB158 \uBCD1" },
-  \uC815: { hanja: "\u4E01", reading: "\uACE0\uBB34\uB798 \uC815" },
-  \uBB34: { hanja: "\u620A", reading: "\uBB34\uC131\uD560 \uBB34" },
-  \uAE30: { hanja: "\u5DF1", reading: "\uBAB8 \uAE30" },
-  \uACBD: { hanja: "\u5E9A", reading: "\uBCC4 \uACBD" },
-  \uC2E0: { hanja: "\u8F9B", reading: "\uB9E4\uC6B8 \uC2E0" },
-  \uC784: { hanja: "\u58EC", reading: "\uBD81\uBC29 \uC784" },
-  \uACC4: { hanja: "\u7678", reading: "\uD5E4\uC544\uB9B4 \uACC4" }
+  \uAC11: { hanja: "\u7532", reading: "\uC591/\uBAA9", reading_en: "Yang Wood" },
+  \uC744: { hanja: "\u4E59", reading: "\uC74C/\uBAA9", reading_en: "Yin Wood" },
+  \uBCD1: { hanja: "\u4E19", reading: "\uC591/\uD654", reading_en: "Yang Fire" },
+  \uC815: { hanja: "\u4E01", reading: "\uC74C/\uD654", reading_en: "Yin Fire" },
+  \uBB34: { hanja: "\u620A", reading: "\uC591/\uD1A0", reading_en: "Yang Earth" },
+  \uAE30: { hanja: "\u5DF1", reading: "\uC74C/\uD1A0", reading_en: "Yin Earth" },
+  \uACBD: { hanja: "\u5E9A", reading: "\uC591/\uAE08", reading_en: "Yang Metal" },
+  \uC2E0: { hanja: "\u8F9B", reading: "\uC74C/\uAE08", reading_en: "Yin Metal" },
+  \uC784: { hanja: "\u58EC", reading: "\uC591/\uC218", reading_en: "Yang Water" },
+  \uACC4: { hanja: "\u7678", reading: "\uC74C/\uC218", reading_en: "Yin Water" }
 };
 var BRANCH_HANJA = {
-  \uC790: { hanja: "\u5B50", reading: "\uC544\uB4E4 \uC790" },
-  \uCD95: { hanja: "\u4E11", reading: "\uC18C \uCD95" },
-  \uC778: { hanja: "\u5BC5", reading: "\uBC94 \uC778" },
-  \uBB18: { hanja: "\u536F", reading: "\uD1A0\uB07C \uBB18" },
-  \uC9C4: { hanja: "\u8FB0", reading: "\uBCC4 \uC9C4" },
-  \uC0AC: { hanja: "\u5DF3", reading: "\uBC40 \uC0AC" },
-  \uC624: { hanja: "\u5348", reading: "\uB0AE \uC624" },
-  \uBBF8: { hanja: "\u672A", reading: "\uC544\uB2D0 \uBBF8" },
-  \uC2E0: { hanja: "\u7533", reading: "\uD3BC \uC2E0" },
-  \uC720: { hanja: "\u9149", reading: "\uB2ED \uC720" },
-  \uC220: { hanja: "\u620C", reading: "\uAC1C \uC220" },
-  \uD574: { hanja: "\u4EA5", reading: "\uB3FC\uC9C0 \uD574" }
+  \uC790: { hanja: "\u5B50", reading: "\uC950", reading_en: "Mouse" },
+  \uCD95: { hanja: "\u4E11", reading: "\uC18C", reading_en: "Cow" },
+  \uC778: { hanja: "\u5BC5", reading: "\uBC94", reading_en: "Tiger" },
+  \uBB18: { hanja: "\u536F", reading: "\uD1A0\uB07C", reading_en: "Rabbit" },
+  \uC9C4: { hanja: "\u8FB0", reading: "\uC6A9", reading_en: "Dragon" },
+  \uC0AC: { hanja: "\u5DF3", reading: "\uBC40", reading_en: "Snake" },
+  \uC624: { hanja: "\u5348", reading: "\uB9D0", reading_en: "Horse" },
+  \uBBF8: { hanja: "\u672A", reading: "\uC591", reading_en: "Sheep" },
+  \uC2E0: { hanja: "\u7533", reading: "\uC6D0\uC22D\uC774", reading_en: "Monkey" },
+  \uC720: { hanja: "\u9149", reading: "\uB2ED", reading_en: "Chicken" },
+  \uC220: { hanja: "\u620C", reading: "\uAC1C", reading_en: "Dog" },
+  \uD574: { hanja: "\u4EA5", reading: "\uB3FC\uC9C0", reading_en: "Pig" }
 };
 var TEN_GOD_HANJA = {
-  \uBE44\uACAC: { hanja: "\u6BD4\u80A9", reading: "\uACAC\uC904 \uBE44\xB7\uC5B4\uAE68 \uACAC" },
-  \uAC81\uC7AC: { hanja: "\u52AB\u8CA1", reading: "\uC704\uD611\uD560 \uAC81\xB7\uC7AC\uBB3C \uC7AC" },
-  \uC2DD\uC2E0: { hanja: "\u98DF\u795E", reading: "\uBA39\uC744 \uC2DD\xB7\uADC0\uC2E0 \uC2E0" },
-  \uC0C1\uAD00: { hanja: "\u50B7\u5B98", reading: "\uB2E4\uCE60 \uC0C1\xB7\uBCBC\uC2AC \uAD00" },
-  \uD3B8\uC7AC: { hanja: "\u504F\u8CA1", reading: "\uCE58\uC6B0\uCE60 \uD3B8\xB7\uC7AC\uBB3C \uC7AC" },
-  \uC815\uC7AC: { hanja: "\u6B63\u8CA1", reading: "\uBC14\uB97C \uC815\xB7\uC7AC\uBB3C \uC7AC" },
-  \uD3B8\uAD00: { hanja: "\u504F\u5B98", reading: "\uCE58\uC6B0\uCE60 \uD3B8\xB7\uBCBC\uC2AC \uAD00" },
-  \uC815\uAD00: { hanja: "\u6B63\u5B98", reading: "\uBC14\uB97C \uC815\xB7\uBCBC\uC2AC \uAD00" },
-  \uD3B8\uC778: { hanja: "\u504F\u5370", reading: "\uCE58\uC6B0\uCE60 \uD3B8\xB7\uB3C4\uC7A5 \uC778" },
-  \uC815\uC778: { hanja: "\u6B63\u5370", reading: "\uBC14\uB97C \uC815\xB7\uB3C4\uC7A5 \uC778" },
-  \uBCF8\uC6D0: { hanja: "\u672C\u5143", reading: "\uADFC\uBCF8 \uBCF8\xB7\uC73C\uB738 \uC6D0" }
+  \uBE44\uACAC: { hanja: "\u6BD4\u80A9", reading: "\uACAC\uC904 \uBE44\xB7\uC5B4\uAE68 \uACAC", reading_en: "" },
+  \uAC81\uC7AC: { hanja: "\u52AB\u8CA1", reading: "\uC704\uD611\uD560 \uAC81\xB7\uC7AC\uBB3C \uC7AC", reading_en: "" },
+  \uC2DD\uC2E0: { hanja: "\u98DF\u795E", reading: "\uBA39\uC744 \uC2DD\xB7\uADC0\uC2E0 \uC2E0", reading_en: "" },
+  \uC0C1\uAD00: { hanja: "\u50B7\u5B98", reading: "\uB2E4\uCE60 \uC0C1\xB7\uBCBC\uC2AC \uAD00", reading_en: "" },
+  \uD3B8\uC7AC: { hanja: "\u504F\u8CA1", reading: "\uCE58\uC6B0\uCE60 \uD3B8\xB7\uC7AC\uBB3C \uC7AC", reading_en: "" },
+  \uC815\uC7AC: { hanja: "\u6B63\u8CA1", reading: "\uBC14\uB97C \uC815\xB7\uC7AC\uBB3C \uC7AC", reading_en: "" },
+  \uD3B8\uAD00: { hanja: "\u504F\u5B98", reading: "\uCE58\uC6B0\uCE60 \uD3B8\xB7\uBCBC\uC2AC \uAD00", reading_en: "" },
+  \uC815\uAD00: { hanja: "\u6B63\u5B98", reading: "\uBC14\uB97C \uC815\xB7\uBCBC\uC2AC \uAD00", reading_en: "" },
+  \uD3B8\uC778: { hanja: "\u504F\u5370", reading: "\uCE58\uC6B0\uCE60 \uD3B8\xB7\uB3C4\uC7A5 \uC778", reading_en: "" },
+  \uC815\uC778: { hanja: "\u6B63\u5370", reading: "\uBC14\uB97C \uC815\xB7\uB3C4\uC7A5 \uC778", reading_en: "" },
+  \uBCF8\uC6D0: { hanja: "\u672C\u5143", reading: "\uADFC\uBCF8 \uBCF8\xB7\uC73C\uB738 \uC6D0", reading_en: "" }
 };
 
 // src/domain/sexagenaryCycle.ts
@@ -312,6 +317,9 @@ function daysInMonth(year, month) {
 function isValidDate(year, month, day) {
   return month >= 1 && month <= 12 && day >= 1 && day <= daysInMonth(year, month);
 }
+function compareLocalDate(left, right) {
+  return left.year - right.year || left.month - right.month || left.day - right.day;
+}
 function compareLocalDateTime(left, right) {
   const keys = ["year", "month", "day", "hour", "minute"];
   for (const key of keys) {
@@ -1823,11 +1831,23 @@ function getMonthBranchBySolarTerm(dateTime) {
   }
   return selected;
 }
+function getMonthBranchBySolarDate(date) {
+  const rules = [...SOLAR_TERM_RULES].sort((left, right) => left.month - right.month);
+  let selected = "\uCD95";
+  for (const rule of rules) {
+    if (compareLocalDate(date, solarTermDateTime(date.year, rule)) >= 0)
+      selected = rule.monthBranch;
+  }
+  return selected;
+}
 
 // src/saju/calculateDayPillar.ts
 var JDN_TO_SEXAGENARY_OFFSET = 49;
 function calculateDayPillar(dateTime) {
-  const jdn = julianDayNumber(dateTime.year, dateTime.month, dateTime.day);
+  return calculateDayPillarFromDate(dateTime);
+}
+function calculateDayPillarFromDate(date) {
+  const jdn = julianDayNumber(date.year, date.month, date.day);
   return pillarFromIndex(positiveModulo(jdn + JDN_TO_SEXAGENARY_OFFSET, 60));
 }
 
@@ -1880,6 +1900,9 @@ var IN_MONTH_START_STEM_BY_YEAR_STEM = {
 };
 function calculateMonthPillar(dateTime, yearStem) {
   const branch = getMonthBranchBySolarTerm(dateTime);
+  return monthPillarFromBranch(branch, yearStem);
+}
+function monthPillarFromBranch(branch, yearStem) {
   const offsetFromIn = positiveModulo(branchIndex(branch) - branchIndex("\uC778"), 12);
   const stem = stemAt(IN_MONTH_START_STEM_BY_YEAR_STEM[yearStem] + offsetFromIn);
   return { stem, branch };
@@ -1933,14 +1956,20 @@ function calculateTenGod(dayStem, targetStem) {
 
 // src/saju/calculateTenGods.ts
 function calculateTenGods(fourPillars) {
+  const dayStem = fourPillars.day.stem;
+  return {
+    ...calculateDateTenGods(fourPillars),
+    hourStem: calculateTenGod(dayStem, fourPillars.hour.stem),
+    hourBranch: calculateTenGod(dayStem, BRANCH_INFO[fourPillars.hour.branch].mainHiddenStem)
+  };
+}
+function calculateDateTenGods(fourPillars) {
   const dayStem = fourPillars.day.stem;
   return {
     yearStem: calculateTenGod(dayStem, fourPillars.year.stem),
     yearBranch: calculateTenGod(dayStem, BRANCH_INFO[fourPillars.year.branch].mainHiddenStem),
     monthStem: calculateTenGod(dayStem, fourPillars.month.stem),
     monthBranch: calculateTenGod(dayStem, BRANCH_INFO[fourPillars.month.branch].mainHiddenStem),
-    dayBranch: calculateTenGod(dayStem, BRANCH_INFO[fourPillars.day.branch].mainHiddenStem),
-    hourStem: calculateTenGod(dayStem, fourPillars.hour.stem),
-    hourBranch: calculateTenGod(dayStem, BRANCH_INFO[fourPillars.hour.branch].mainHiddenStem)
+    dayBranch: calculateTenGod(dayStem, BRANCH_INFO[fourPillars.day.branch].mainHiddenStem)
   };
 }