@fivepixels-js/cli 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,206 @@
+# Fivepixels CLI
+
+`@fivepixels-js/cli` `0.1.0`은 `fivepixels` 명령으로 Lite API를 실행·관리하는 독립 CLI입니다. API 프로젝트나 SDK를 이 저장소로 옮기지 않습니다.
+
+## 관련 저장소와 런타임
+
+- [fivepixels-cli](https://github.com/siwan315/fivepixels-cli): 이 CLI의 독립 Git 저장소
+- [fivepixels-lite-api](https://github.com/siwan315/fivepixels-lite-api): HTTP 서버·DB를 소유하는 독립 Git 저장소. 환경변수, 인증, DDL, Docker, 백업·복원 상세 안내는 이 저장소의 README를 참고하십시오.
+
+소스 저장소는 비공개이므로 접근 권한이 필요합니다. npm 패키지 설치에는 소스 checkout이 필요하지 않습니다. 개발 환경 구성은 아래의 **소스 개발 설치**를 참고하십시오.
+
+런타임 의존성은 공개 진입점이 추가된 `@fivepixels-js/lite-api` **`0.2.1`로 정확히 고정**합니다. 같은 버전이라도 runtime export가 없는 이전 개발 tarball은 사용할 수 없습니다. CLI 패키지에 Lite 코드를 복사해 묶지는 않습니다.
+
+## 라이선스
+
+Copyright (c) 2026 Fivepixels
+
+이 저장소의 CLI 자체 코드는 [Apache License 2.0](LICENSE), SPDX 식별자 `Apache-2.0`으로 제공합니다.
+
+함께 설치되는 `@fivepixels-js/lite-api` 서버는 별도의 **Elastic License 2.0 (`Elastic-2.0`)**을 따릅니다. API 서버는 source-available이며, CLI의 Apache-2.0 라이선스가 서버에 재라이선스되거나 서버의 호스팅·관리형 서비스 제공 제한을 해제하지 않습니다. 공개 runtime과 기존 `fivepixels-lite-api` 명령도 서버 패키지에 속합니다.
+
+서버의 정확한 조건은 설치된 `@fivepixels-js/lite-api/LICENSE`와 [서버 README](https://github.com/siwan315/fivepixels-lite-api#라이선스)를 확인하십시오. 다른 제3자 의존성도 각자의 라이선스·고지를 유지합니다. 이 저장소 변경은 SDK나 다른 API 저장소의 라이선스 파일을 변경하지 않습니다.
+
+이전에 적법하게 배포된 MIT 코드의 권한을 소급해서 회수하지 않습니다. 배포자는 외부 기여·제3자 코드의 권리와 과거 배포 이력을 별도로 확인해야 합니다.
+
+## 요구사항
+
+- Node.js 22 또는 24 LTS, npm 10 이상 권장
+- DB를 둘 로컬 디스크. NFS/SMB/NAS는 사용하지 않습니다.
+
+## 빠른 시작
+
+### 1. npm 설치
+
+패키지 이름은 `@fivepixels-js/cli`이고 실행 명령은 `fivepixels`입니다.
+
+```bash
+npm install -g @fivepixels-js/cli
+fivepixels --help
+fivepixels --version
+```
+
+순서대로 npm의 `latest` 태그에 연결된 CLI를 전역 설치하고 도움말·CLI 버전을 확인합니다. 버전 접미사는 패키지 이름의 일부가 아니며, 특정 버전이 필요한 경우에만 `@fivepixels-js/cli@0.1.0`처럼 지정합니다. 이 문서의 CLI `0.1.0`은 Lite `0.2.1`을 함께 설치하고 정확한 호환 버전을 유지합니다. 설치·도움말·버전 조회만으로 서버·DB·JWT 키는 생성하지 않습니다.
+
+### 2. 개발용 DB 초기화와 서버 실행
+
+이후 명령은 모두 같은 작업 디렉터리에서 실행합니다. `../fivepixels-local-data/cli/data.db`는 개발용 예시입니다. 기존 운영 데이터가 없는 경로인지 확인하고, 다른 배포의 토큰·JWT 파일 환경변수가 적용되지 않은 셸을 사용하십시오.
+
+```bash
+fivepixels init --db-path ../fivepixels-local-data/cli/data.db
+fivepixels start --host 127.0.0.1 --port 3000 --db-path ../fivepixels-local-data/cli/data.db
+```
+
+`init`은 해당 DB·마이그레이션과 DB 옆 JWT 키를 준비하고, `start`는 같은 DB로 포그라운드 서버를 실행합니다. 기존 DB를 지정하면 pending migration이 적용될 수 있습니다. 3000 포트가 사용 중이면 이후 조회 명령까지 같은 새 포트로 변경하십시오.
+
+### 3. 별도 터미널에서 상태 확인과 백업
+
+두 번째 터미널도 같은 작업 디렉터리에서 실행합니다.
+
+```bash
+fivepixels status --host 127.0.0.1 --port 3000 --db-path ../fivepixels-local-data/cli/data.db
+node -e "fetch('http://127.0.0.1:3000/health').then(r => { if (!r.ok) throw new Error('HTTP ' + r.status); return r.json(); }).then(console.log)"
+fivepixels backup --db-path ../fivepixels-local-data/cli/data.db
+```
+
+순서대로 HTTP·DB·마이그레이션 상태를 확인하고, health 응답의 `status: 'ok'`, `database: 'ok'`를 확인한 뒤 DB 옆 `backups/`에 온라인 백업을 만듭니다. 기존 백업은 덮어쓰지 않습니다. `status`는 DB가 없으면 생성하지 않으며, 서버가 없거나 미적용 마이그레이션이 있으면 종료 코드 `1`을 반환합니다.
+
+### 4. 정상 종료와 마이그레이션 확인
+
+서버를 시작한 첫 번째 터미널에서 Ctrl+C로 종료한 뒤 실행합니다.
+
+```bash
+fivepixels migrate --db-path ../fivepixels-local-data/cli/data.db
+```
+
+서버를 다시 열지 않고 미적용 마이그레이션을 적용합니다. 최신 DB라면 `No pending migrations.`가 정상입니다. CLI에는 `stop` 명령이 없으며, POSIX에서는 기존 SIGINT/SIGTERM 종료 처리를 사용합니다.
+
+모든 데이터 명령에서 같은 `--db-path`를 유지하십시오. 생략하면 OS별 기본 데이터 경로를 사용하므로 위 개발 DB가 아닌 다른 DB를 조회·생성·마이그레이션할 수 있습니다.
+
+## 역할과 지원 범위
+
+| 주체 | 책임 |
+|---|---|
+| 이 CLI | 명령·도움말·CLI 버전, Lite 버전/공개 진입점 확인 |
+| Lite API | HTTP 서버, 설정·보안 검증, JWT 키, DB·마이그레이션·온라인 백업 |
+| SDK | HTTP API 호출. 이번 CLI 분리로 요청 계약은 바뀌지 않음 |
+
+CLI는 `@fivepixels-js/lite-api/package.json`과 `@fivepixels-js/lite-api/runtime`만 사용합니다. DB 모듈이나 내부 src/dist 파일을 직접 불러오지 않습니다. Lite를 같은 Node 프로세스에서 실행하므로 별도 서버 자식 프로세스나 종료 신호 전달 계층을 두지 않습니다.
+
+현재 지원은 Lite뿐입니다. selfdev 선택, Docker 관리, stop/logs/restore/upgrade, API 버전 선택, 자동 다운로드·복구는 포함하지 않습니다. 기존 `fivepixels-lite-api` 명령과 Lite Docker 진입점은 그대로 사용할 수 있습니다.
+
+## 명령과 설정
+
+아래 표는 설치된 `fivepixels` 명령 기준입니다. 소스 개발 설치에서는 `fivepixels` 대신 `node dist/index.js`를 사용합니다.
+
+| 명령 | 의미 |
+|---|---|
+| `fivepixels init` | 데이터 디렉터리·DB·JWT 키 초기화 |
+| `fivepixels start` | 미적용 마이그레이션 후 포그라운드 API 실행 |
+| `fivepixels status` | HTTP·DB·마이그레이션 상태 확인; 없는 DB를 만들지 않음 |
+| `fivepixels backup` | SQLite 온라인 백업·무결성 확인; 기존 백업을 덮어쓰지 않음 |
+| `fivepixels migrate` | 미적용 마이그레이션 실행 |
+| `fivepixels --help`, `fivepixels --version` | CLI 도움말·버전; DB·서버 작업 없음 |
+
+`--db-path`, `--host`, `--port`, `--log-level`, `--cors-origin`, `--docs-enabled`, `--admin-token-file`, `--jwt-secret-file`, `--registration-enabled`, `--trust-proxy`, 백업 전용 `--output`을 그대로 Lite로 전달합니다. 옵션 값은 Lite가 검증합니다. `--docs-enabled`, `--registration-enabled`에는 `true` 또는 `false` 값을 명시합니다.
+
+설정은 `CLI 옵션 > 환경변수 > 기본값`입니다. 기본 수신은 `127.0.0.1:3000`, CORS는 비활성입니다. 외부 바인딩에는 32자 이상의 관리 토큰이 필요하며, 원문 명령줄 옵션이 아닌 `--admin-token-file` 또는 Lite 환경변수를 사용합니다. 관리 토큰은 업무 API의 사용자 JWT를 대신하지 않습니다. 실제 .env/DB/키/백업을 저장소나 패키지에 넣지 마십시오.
+
+종료 코드는 성공 `0`, 실행 실패 `1`, 잘못된 명령·설정 `2`입니다. `--version`은 CLI 버전 `0.1.0`이며 API 버전 `0.2.1`과 다릅니다. 버전 불일치·runtime 누락은 데이터 작업 전에 실패합니다. 제품 명령 실행 중 npm/npx를 호출하지 않습니다.
+
+## 소스 개발 설치
+
+Lite와 CLI의 소스 checkout 접근 권한이 필요합니다. 다음 예시는 `fivepixels-lite-api`와 `fivepixels-cli` 디렉터리가 같은 상위 디렉터리에 있는 경우입니다. npm 패키지 이름 공간과 Git 저장소·디렉터리 이름은 서로 다릅니다.
+
+### 1. Lite tarball 준비
+
+두 checkout의 버전·변경 내용을 먼저 확인한 뒤 **Lite 디렉터리**에서 실행합니다.
+
+```bash
+npm ci
+npm pack
+```
+
+의존성을 설치하고 Lite를 빌드하여 `fivepixels-js-lite-api-0.2.1.tgz`를 만듭니다. npm 공개는 하지 않습니다.
+
+### 2. CLI 의존성 설치와 빌드
+
+**CLI 디렉터리**로 이동해 실행합니다. Lite가 다른 위치에 있으면 tarball 경로를 실제 위치로 바꾸십시오.
+
+```bash
+npm run setup:local -- ../fivepixels-lite-api/fivepixels-js-lite-api-0.2.1.tgz
+npm run build
+node dist/index.js --help
+node dist/index.js --version
+```
+
+순서대로 Lite tarball을 검증·준비하고 고정 lockfile로 의존성을 설치한 뒤 CLI를 빌드하고 도움말·CLI 버전 `0.1.0`을 확인합니다. **전역 `fivepixels` 명령은 설치되지 않으므로 개발 중에는 `node dist/index.js`로 실행합니다.** 빠른 시작의 `fivepixels`를 `node dist/index.js`로 바꾸되 같은 `--db-path`를 유지하십시오. 설치·빌드·도움말·버전 조회만으로 서버·DB·JWT 키는 생성하지 않습니다.
+
+개발용 `package-lock.json`은 Lite tarball을 `.artifacts/`의 상대 경로와 실제 SHA-512로 고정합니다. `.artifacts/`는 Git/npm 패키지에서 제외됩니다. 새 checkout에서 바로 `npm ci`를 실행하지 말고 `setup:local`로 tarball을 먼저 공급하십시오. 공개 `package.json`의 의존성은 `0.2.1`이며 로컬 경로가 아닙니다.
+
+**`Tarball differs from the reviewed lock`가 나오면 여기서 멈추십시오.** Lite의 README만 바뀌어도 체크섬은 달라집니다. lockfile은 ELv2 라이선스·문서·메타데이터를 포함한 검토된 Lite tarball의 체크섬으로 고정됩니다. 이후 소스나 포함 문서를 다시 수정해 pack하면 재검토가 필요합니다. 새 tarball의 소스·포함 파일을 검토한 뒤 승인한 개발 변경에 대해서만 다음 명령으로 갱신합니다.
+
+```bash
+npm run setup:local -- --update-lock ../fivepixels-lite-api/fivepixels-js-lite-api-0.2.1.tgz
+npm run build
+node dist/index.js --version
+```
+
+첫 명령은 이름·버전·필수 파일을 확인하고 개발용 Lite의 경로·체크섬을 갱신한 뒤 의존성을 재설치합니다. 나머지 고정 의존성은 유지합니다. 이후 CLI를 다시 빌드하고 아래 연동 검증까지 수행해야 합니다. 검증을 우회하려고 임의의 tarball을 승인하거나 CI에 `--update-lock`을 넣지 마십시오.
+
+## 검증
+
+개발 설치와 빌드가 끝난 CLI 디렉터리에서 실행합니다.
+
+```bash
+npm run typecheck
+npm run lint
+npm test
+npm run test:package
+```
+
+타입 검사, 정적 검사, 단위/구조 테스트, 실제 tarball 설치·실행 검증입니다. 마지막 명령의 기본 로컬 모드는 CLI를 빌드·패키징한 뒤 준비된 Lite tarball과 함께 임시 위치에 설치하고 다음을 검증합니다.
+
+- 설치·help/version/status에서 불필요한 DB·키가 생성되지 않음
+- 모든 옵션 전달, 외부 바인딩 보안 거부, 공개 runtime import의 무부작용
+- init/start/health/status/온라인 backup/migrate, 백업 무결성·FK·미덮어쓰기
+- 기존 Lite 명령과 새 CLI가 같은 DB를 정상 사용
+- POSIX에서 실제 CLI SIGINT/SIGTERM 정상 종료 코드 0과 포트 해제
+- 패키지 allowlist, CLI shebang·실행 권한, 민감 파일 제외
+
+이미 생성한 CLI 패키지를 검증할 때는 `test:package`에 `--cli-tarball <CLI tgz 경로>`와 `--cli-integrity <준비 단계의 SHA-512>`를 함께 전달합니다. 이 모드는 CLI를 다시 빌드·압축하지 않으며, 설치 전에 파일 체크섬·패키지 이름/버전·실행 권한을 검사합니다. 둘 중 하나가 없거나 체크섬이 다르면 설치하지 않습니다. Lite tarball은 기존 `--lite-tarball` 옵션과 lockfile의 고정 SHA-512로 검증합니다.
+
+Windows의 파일 권한 표현 차이로 로컬 재패키징 결과가 POSIX 아카이브와 달라질 수 있습니다. Windows에서는 CI 준비 단계에서 제공한 두 tgz와 CLI SHA-512를 사용하는 입력 모드를 권장합니다. 체크섬을 Windows 값으로 덮어쓰거나 실행 권한 검사를 생략하지 않습니다.
+
+`.gitattributes`는 checkout 줄바꿈을 LF로 고정합니다. CI에서 내려받은 `.runtime-source/`와 준비된 `.artifacts/`는 CLI lint 범위에서 제외합니다. API의 검증은 Lite 저장소에서 별도로 수행하고, CLI 검증이 API 테스트를 대신한다고 보지 않습니다.
+
+의존성 캐시가 모두 준비된 경우에만 `setup:local` 또는 `test:package`에 `--offline`을 추가합니다. 예를 들어 `npm run test:package -- --offline`은 네트워크 다운로드 없이 패키지 연동을 검증하며 캐시가 부족하면 실패합니다.
+
+테스트의 SQLite 직접 검사는 테스트 스크립트에만 있고 제품 CLI에는 없습니다. 테스트는 임시 DB만 사용하며 성공 시 임시 설치·DB·키·백업을 정리합니다. 실패한 임시 경로는 진단을 위해 표시하고 보존합니다.
+
+기존 로컬 실행 검증은 macOS / Node 24 기준입니다. Windows에서는 process.kill이 POSIX 종료 신호와 같지 않으므로 테스트가 실제 콘솔 Ctrl+C 정상 종료를 보장하지 않습니다. Windows 콘솔 종료는 별도 release 점검 대상입니다.
+
+## CI 실행 조건
+
+CI는 Linux의 패키지 준비 단계와 Node 22·24 및 Linux/macOS/Windows의 6개 검증 단계로 나뉩니다. 준비 단계에서 Lite와 CLI tgz를 한 번 생성·검증한 뒤, 같은 실행의 artifact ID로 두 파일만 전달합니다. 6개 환경은 동일한 아카이브를 설치하므로 OS별 재패키징 권한 차이를 피하며, 각 환경의 타입 검사·lint·단위 테스트·빌드는 유지합니다.
+
+Lite 체크섬은 기존 lockfile에 고정하고, CLI 체크섬은 준비 단계의 SHA-512 출력과 대조합니다. 체크섬·실행 권한 검증을 통과한 tgz만 artifact에 포함하며 소스 checkout·토큰·설치 디렉터리·테스트 DB는 업로드하지 않습니다. Artifact 보존 기간은 7일입니다. 업로드·다운로드 액션은 커밋 SHA로 고정합니다.
+
+- 기본 push/PR CI와 입력이 없는 수동 실행은 `fetch:runtime`으로 공개된 정확한 Lite tarball을 가져옵니다. Lite 선행 공개 전에는 이 단계에서 실패합니다.
+- 공개 이후에도 실제 tarball과 CLI lockfile의 체크섬을 검토·일치시켜야 합니다. 버전 문자열만 같다고 통과하는 것은 아닙니다.
+- 미공개 수동 검증은 `lite_repository=siwan315/fivepixels-lite-api`와 `lite_ref`에 검토된 **전체 40자리 커밋 SHA**를 지정합니다. 브랜치·태그·짧은 SHA·다른 저장소는 checkout 전에 거부합니다. 해당 커밋은 원격에 올라가 있어야 합니다.
+- 다른 비공개 저장소는 CLI 저장소의 기본 `GITHUB_TOKEN`으로 읽을 수 없습니다. 수동 소스 checkout에는 `LITE_REPOSITORY_TOKEN` secret을 사용하며, Lite 저장소에만 `Contents: read` 권한이 있는 fine-grained PAT 등 최소 읽기 권한의 토큰을 별도로 준비해야 합니다. 토큰이 없으면 명확한 오류로 중단하고 checkout 인증은 저장하지 않습니다. [GitHub 공식 안내](https://github.com/actions/checkout#checkout-multiple-repos-private)
+
+수동 소스 검증에는 CLI 저장소의 Settings → Secrets and variables → Actions에 `LITE_REPOSITORY_TOKEN` 등록이 필요합니다. 이 토큰은 패키지 준비 단계의 소스 확인에만 사용하며 6개 검증 단계에는 전달하지 않습니다. 토큰을 README나 입력 문자열에 붙여 넣지 마십시오. `fetch:runtime`은 개발/CI 준비 도구이며 제품 CLI의 자동 다운로드 기능이 아닙니다. CI 설정 존재가 모든 환경의 통과를 의미하지는 않으므로 해당 커밋의 실제 실행 결과를 확인하십시오.
+
+## 공개와 운영 주의
+
+1. README·포함 파일·민감정보를 점검하고 `@fivepixels-js` npm 이름 공간의 소유·배포 권한을 확인합니다.
+2. `package.json`의 `repository`, `homepage`, `bugs`는 `siwan315/fivepixels-cli`로 연결되어 있습니다. 공개 전 실제 저장소·이슈 접근 정책을 다시 확인합니다.
+3. 호환 Lite `0.2.1`을 먼저 공개합니다.
+4. 실제 공개 Lite tarball이 검토한 파일과 같은지 SHA-512를 비교하고, registry 기반 설치·CI·패키지 연동을 재검증합니다. 개발용 lock의 `.artifacts/` 경로·체크섬은 유지하며 조회한 버전의 파일이 다르면 공개를 중단합니다.
+5. 검증 후 CLI `0.1.0`을 공개합니다.
+
+현재 두 패키지의 `publishConfig.access`는 `public`입니다. GitHub가 비공개여도 npm에 배포한 코드·문서는 공개되므로 파일의 공개 범위를 별도로 확인해야 합니다. npm 공개, Git commit/push, 인증·권한 변경, 운영 배포는 각각 명시적으로 승인한 단계에서만 수행합니다.
+
+실제 운영 명령 실행 전 DB 경로·로컬 디스크·포트·권한·토큰 파일·백업 상태를 확인하십시오. 이번 CLI 분리 자체에 새 DB 마이그레이션은 없습니다. 기존 Lite의 pending migration은 `start/init/migrate`에서 기존 규칙대로 실행될 수 있습니다. CLI 문제가 생기면 기존 `fivepixels-lite-api` 명령을 사용하면 되며, 분리만 되돌리는 데 DB 복원이나 DDL 재실행은 필요하지 않습니다.

package/dist/adapters/lite.d.ts

@@ -0,0 +1,10 @@
+export type RuntimeCommand = (args: string[]) => Promise<number>;
+export interface RuntimeLoader {
+    metadata: () => unknown;
+    runtime: () => Promise<unknown>;
+}
+export declare class LiteRuntimeError extends Error {
+}
+/** Only public package metadata and the public runtime entrypoint are loaded. */
+export declare function loadLiteRuntime(loader?: RuntimeLoader): Promise<RuntimeCommand>;
+//# sourceMappingURL=lite.d.ts.map

package/dist/adapters/lite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lite.d.ts","sourceRoot":"","sources":["../../src/adapters/lite.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAY9C,iFAAiF;AACjF,wBAAsB,eAAe,CAAC,MAAM,GAAE,aAAgC,GAAG,OAAO,CAAC,cAAc,CAAC,CAoBvG"}

package/dist/adapters/lite.js

@@ -0,0 +1,37 @@
+import { createRequire } from 'node:module';
+import { LITE_VERSION } from '../version.js';
+export class LiteRuntimeError extends Error {
+}
+const require = createRequire(import.meta.url);
+const installedRuntime = {
+    metadata: () => require('@fivepixels-js/lite-api/package.json'),
+    runtime: () => import('@fivepixels-js/lite-api/runtime'),
+};
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+/** Only public package metadata and the public runtime entrypoint are loaded. */
+export async function loadLiteRuntime(loader = installedRuntime) {
+    let metadata;
+    try {
+        metadata = loader.metadata();
+    }
+    catch {
+        throw new LiteRuntimeError('Lite runtime is missing. Reinstall @fivepixels-js/cli with its dependencies.');
+    }
+    if (!isRecord(metadata) || metadata.name !== '@fivepixels-js/lite-api' || metadata.version !== LITE_VERSION) {
+        throw new LiteRuntimeError('Unsupported Lite runtime. Required version: @fivepixels-js/lite-api ' + LITE_VERSION + '.');
+    }
+    let runtime;
+    try {
+        runtime = await loader.runtime();
+    }
+    catch {
+        throw new LiteRuntimeError('Lite runtime entrypoint is unavailable. Install the compatible runtime with @fivepixels-js/cli.');
+    }
+    if (!isRecord(runtime) || typeof runtime.runRuntimeCommand !== 'function') {
+        throw new LiteRuntimeError('Lite runtime does not provide runRuntimeCommand. Install the compatible runtime.');
+    }
+    return runtime.runRuntimeCommand;
+}
+//# sourceMappingURL=lite.js.map

package/dist/adapters/lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lite.js","sourceRoot":"","sources":["../../src/adapters/lite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAS7C,MAAM,OAAO,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,gBAAgB,GAAkB;IACtC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAY;IAC1E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iCAAiC,CAAC;CACzD,CAAC;AAEF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAwB,gBAAgB;IAC5E,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CAAC,8EAA8E,CAAC,CAAC;IAC7G,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,yBAAyB,IAAI,QAAQ,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;QAC5G,MAAM,IAAI,gBAAgB,CAAC,sEAAsE,GAAG,YAAY,GAAG,GAAG,CAAC,CAAC;IAC1H,CAAC;IACD,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CAAC,iGAAiG,CAAC,CAAC;IAChI,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QAC1E,MAAM,IAAI,gBAAgB,CAAC,kFAAkF,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,OAAO,CAAC,iBAAmC,CAAC;AACrD,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+import { type RuntimeCommand } from './adapters/lite.js';
+import { type CommandIo } from './io.js';
+export declare function runCli(args: string[], io?: CommandIo, loadRuntime?: () => Promise<RuntimeCommand>): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAuDpD,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,SAAqB,EACzB,WAAW,GAAE,MAAM,OAAO,CAAC,cAAc,CAAmB,GAC3D,OAAO,CAAC,MAAM,CAAC,CAgCjB"}

package/dist/cli.js

@@ -0,0 +1,89 @@
+import { parseArgs } from 'node:util';
+import { LiteRuntimeError, loadLiteRuntime } from './adapters/lite.js';
+import { consoleIo } from './io.js';
+import { CLI_VERSION, LITE_VERSION } from './version.js';
+const HELP = `Fivepixels CLI ${CLI_VERSION}
+
+Usage:
+  fivepixels <command> [options]
+  fivepixels --help
+  fivepixels --version
+
+Commands:
+  init       Initialize the Lite data directory, database and JWT key
+  start      Run migrations and start the Lite API in the foreground
+  status     Check HTTP, database and migration status
+  backup     Create an online SQLite backup
+  migrate    Apply pending database migrations
+
+Options:
+  --host <host>
+  --port <port>
+  --db-path <path>
+  --log-level <level>
+  --cors-origin <origins>
+  --docs-enabled <true|false>
+  --admin-token-file <path>
+  --jwt-secret-file <path>
+  --registration-enabled <true|false>
+  --trust-proxy <addresses>
+  --output <path>                Backup output path (backup only)
+  -h, --help
+  -v, --version
+
+Runtime: @fivepixels-js/lite-api ${LITE_VERSION}
+Settings and security checks belong to Lite. Use local storage for SQLite.
+The CLI does not download or upgrade runtimes while running commands.
+`;
+// Public argument syntax only. Value validation and configuration belong to Lite.
+const options = {
+    'admin-token-file': { type: 'string' },
+    'cors-origin': { type: 'string' },
+    'db-path': { type: 'string' },
+    'docs-enabled': { type: 'string' },
+    help: { type: 'boolean', short: 'h' },
+    host: { type: 'string' },
+    'jwt-secret-file': { type: 'string' },
+    'log-level': { type: 'string' },
+    output: { type: 'string' },
+    port: { type: 'string' },
+    'registration-enabled': { type: 'string' },
+    'trust-proxy': { type: 'string' },
+    version: { type: 'boolean', short: 'v' },
+};
+const commands = new Set(['init', 'start', 'status', 'backup', 'migrate']);
+export async function runCli(args, io = consoleIo, loadRuntime = loadLiteRuntime) {
+    try {
+        const { positionals, values } = parseArgs({ args, options, strict: true, allowPositionals: true });
+        if (values.version) {
+            io.output(CLI_VERSION);
+            return 0;
+        }
+        if (values.help) {
+            io.output(HELP);
+            return 0;
+        }
+        if (positionals.length !== 1 || !commands.has(positionals[0])) {
+            io.error('A supported command is required. Use fivepixels --help for usage.');
+            return 2;
+        }
+        if (values.output !== undefined && positionals[0] !== 'backup') {
+            io.error('--output can only be used with the backup command.');
+            return 2;
+        }
+    }
+    catch {
+        // Never echo untrusted arguments: they can contain credentials.
+        io.error('Invalid command arguments. Use fivepixels --help for usage.');
+        return 2;
+    }
+    try {
+        const run = await loadRuntime();
+        return await run([...args]);
+    }
+    catch (error) {
+        io.error(error instanceof LiteRuntimeError ? error.message : 'Lite command failed. Check the runtime installation and logs.');
+        return 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from './cli.js';
+process.exitCode = await runCli(process.argv.slice(2));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,6 @@
+export interface CommandIo {
+    output(message: string): void;
+    error(message: string): void;
+}
+export declare const consoleIo: CommandIo;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,SAAS,EAAE,SAGvB,CAAC"}

package/dist/io.js

@@ -0,0 +1,5 @@
+export const consoleIo = {
+    output: message => console.log(message),
+    error: message => console.error(message),
+};
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;CACzC,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const CLI_VERSION: string;
+export declare const LITE_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,QAAmB,CAAC;AAC5C,eAAO,MAAM,YAAY,QAAmD,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+import { readFileSync } from 'node:fs';
+const metadata = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+export const CLI_VERSION = metadata.version;
+export const LITE_VERSION = metadata.dependencies['@fivepixels-js/lite-api'];
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CACU,CAAC;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,yBAAyB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@fivepixels-js/cli",
+  "version": "0.1.0",
+  "description": "Fivepixels CLI for running and managing a compatible Lite API runtime.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siwan315/fivepixels-cli.git"
+  },
+  "homepage": "https://github.com/siwan315/fivepixels-cli#readme",
+  "bugs": {
+    "url": "https://github.com/siwan315/fivepixels-cli/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": "^22.0.0 || ^24.0.0"
+  },
+  "bin": {
+    "fivepixels": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:package": "node scripts/test-package.mjs",
+    "setup:local": "node scripts/setup-local.mjs",
+    "prepack": "npm run build",
+    "fetch:runtime": "node scripts/fetch-runtime.mjs"
+  },
+  "dependencies": {
+    "@fivepixels-js/lite-api": "0.2.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@types/node": "24.13.3",
+    "eslint": "10.9.1",
+    "tsx": "4.23.13",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.69.0",
+    "vitest": "4.1.11"
+  }
+}