@dokebi/cli 0.2.4 → 0.2.5

package/AI.md

@@ -1,4 +1,4 @@
-# AI 작업 안내 — @dokebi/cli 0.2.4 (`dokebi`)
+# AI 작업 안내 — @dokebi/cli 0.2.5 (`dokebi`)
 
 도깨비 프로젝트를 만들고 플러그인·앱·모듈을 설치·제거·업그레이드하는 명령이다. 프로젝트가 가진 「CLI 소유 파일」(생성 등록 코드, 상태, 견본 설정)을 트랜잭션으로 고친다. AI는 이 파일들을 손으로 편집하지 말고 반드시 명령으로 바꾼다. 명령 세부 정의는 [docs/cli/README.md](../../docs/cli/README.md), 설치 생명주기는 [docs/cli/installation.md](../../docs/cli/installation.md), 자동화 계약은 [docs/cli/automation.md](../../docs/cli/automation.md)다.
 
@@ -16,7 +16,7 @@
 | `dokebi migrate [--dry-run]` | 0.1.x JSON 설정 프로젝트를 YAML로 이전 |
 | `dokebi inspect` / `dokebi doctor` | 읽기 전용 진단. doctor는 error 진단이 있으면 종료 1 |
 | `dokebi app add <이름> [--domain <host>]... [--template <이름>] [--inertia [--ssr]]` | `src/apps/<이름>` 앱(D-0030). `--inertia`는 Vue 골격과 Vite 빌드 준비, `--ssr`은 서버 렌더링 준비(D-0039) |
-| `dokebi app remove <이름>` · `app link <앱> <도메인> [--template]` · `app unlink <도메인>` · `app list` | 앱·도메인 관리 |
+| `dokebi app remove <이름>` · `app link <앱> <도메인> [--template]` · `app unlink <도메인>` · `app list` | 앱·도메인 관리. `app remove`는 그 앱을 가리키는 도메인이 남아 있으면 `APP_IN_USE`(먼저 unlink), 등록을 지우며 dokebi.yaml·견본의 `options.dokebi-app.apps.<이름>`(D-0061 앱별 설정)도 지운다(0.2.5; 남기면 다음 시작이 `UNKNOWN_APP`). 폴더는 남는다 |
 | `dokebi module add <이름> [--no-views]` · `module remove` · `module list` | `src/shared/modules/<이름>` 기능 모듈(D-0032) |
 | `dokebi dev` | 개발 실행(앞에서). `src/`·`dokebi.yaml`·`.env`가 바뀌면 drain 뒤 다시 띄움. Vite 설정이 있고 template-inertia ≥0.1.2면 `DOKEBI_VITE_DEV=1`로 Vite 개발 서버를 앱 안에 띄워 **HMR**(빌드 불필요, `.vue`·`views/` 변경은 재시작 없음, D-0045). 옛 template-inertia면 감시 빌드 + 재시작. 띄운 앱에 `DOKEBI_DEV=1`을 넣어 cluster 앱은 워커 1개로 돈다(`DOKEBI_DEV_WORKERS`, D-0044·D-0045) |
 | `dokebi start [--foreground] [--wait-ms <ms>] [--log-max-mb <MB>] [--log-files <n>]` · `stop [--timeout-ms <ms>] [--force]` · `status` · `logs [-n <줄>] [-f]` | 백그라운드 실행·종료·상태·로그와 로그 회전(아래 §2.1, 다음 판, D-0044·D-0053) |

package/dist/config-edit.d.ts

@@ -12,6 +12,12 @@ export declare function parseSetOption(argument: string): SetOption;
 export declare function setWarnings(sets: readonly SetOption[]): Warning[];
 export declare function applySetOptions(source: string, id: string, sets: readonly SetOption[]): string;
 export declare function applyConfigChanges(source: string, id: string, changes: readonly ConfigChange[]): string;
+/**
+ * Removes `options.dokebi-app.apps.<app>` (D-0061 per-app settings) and the `apps` map when it is
+ * left empty; a source without that entry is returned unchanged. dokebi-app refuses to start with
+ * an entry for an app that is not defined (UNKNOWN_APP), so `dokebi app remove` calls this.
+ */
+export declare function removeAppSettings(source: string, app: string): string;
 /** Keeps a removed plugin's section and marks it for a later reinstall or manual cleanup. */
 export declare function markRemoved(source: string, id: string): {
     source: string;

package/dist/config-edit.js

@@ -109,6 +109,22 @@ export function applyConfigChanges(source, id, changes) {
         }
     });
 }
+/**
+ * Removes `options.dokebi-app.apps.<app>` (D-0061 per-app settings) and the `apps` map when it is
+ * left empty; a source without that entry is returned unchanged. dokebi-app refuses to start with
+ * an entry for an app that is not defined (UNKNOWN_APP), so `dokebi app remove` calls this.
+ */
+export function removeAppSettings(source, app) {
+    const path = ['options', 'dokebi-app', 'apps', app];
+    if (!parseDocument(source, { version: '1.2' }).hasIn(path))
+        return source;
+    return edit(source, 'dokebi-app', (document) => {
+        document.deleteIn(path);
+        const apps = document.getIn(['options', 'dokebi-app', 'apps'], true);
+        if (isMap(apps) && apps.items.length === 0)
+            document.deleteIn(['options', 'dokebi-app', 'apps']);
+    });
+}
 /** Keeps a removed plugin's section and marks it for a later reinstall or manual cleanup. */
 export function markRemoved(source, id) {
     const document = parseDocument(source, { version: '1.2' });

package/dist/output.d.ts

@@ -1,3 +1,3 @@
-export declare const CLI_VERSION = "0.2.4";
+export declare const CLI_VERSION = "0.2.5";
 export declare function envelope(command: string, result: unknown, ok?: boolean): object;
 export declare function failure(command: string, error: unknown, mutationStarted: boolean): object;

package/dist/output.js

@@ -1,5 +1,5 @@
 import { CliError } from './errors.js';
-export const CLI_VERSION = '0.2.4';
+export const CLI_VERSION = '0.2.5';
 export function envelope(command, result, ok = true) {
     return { schemaVersion: 1, cliVersion: CLI_VERSION, command, ok, result, error: null };
 }

package/dist/project.js

@@ -3,7 +3,7 @@ import { basename, dirname, join, resolve } from 'node:path';
 import lt from 'semver/functions/lt.js';
 import satisfies from 'semver/functions/satisfies.js';
 import validRange from 'semver/ranges/valid.js';
-import { applyConfigChanges, applySetOptions, markRemoved, setWarnings, } from './config-edit.js';
+import { applyConfigChanges, applySetOptions, markRemoved, removeAppSettings, setWarnings, } from './config-edit.js';
 import { CONFIG_BACKUP, CONFIG_EXAMPLE, CONFIG_FILE, CONFIG_TEMPLATE, ignoreConfig, LEGACY_CONFIG_FILE, migrateConfig, parseProjectConfig, } from './configuration.js';
 import { scaffoldConfig } from './configuration-scaffold.js';
 import { CliError } from './errors.js';
@@ -997,8 +997,29 @@ export class Project {
             state.apps = (state.apps ?? []).filter((app) => app !== name);
             if (!state.apps.length)
                 delete state.apps;
-            await this.writeConfiguration(tx, state, session.configSource);
-            const result = { changed: tx.paths, preserved: [`src/apps/${name}`] };
+            // Its `apps.<name>` settings (D-0061) go too: dokebi-app refuses an entry for an app that
+            // is not defined (UNKNOWN_APP). The sample keeps the same shape when it has the entry.
+            const warnings = [];
+            if (await exists(await securePath(session.root, EXAMPLE))) {
+                const example = await tx.read(EXAMPLE);
+                let next = example;
+                try {
+                    next = removeAppSettings(example, name);
+                }
+                catch (error) {
+                    if (!(error instanceof CliError))
+                        throw error;
+                    warnings.push({ code: 'EXAMPLE_INVALID', path: EXAMPLE });
+                }
+                if (next !== example)
+                    await tx.write(EXAMPLE, next);
+            }
+            await this.writeConfiguration(tx, state, removeAppSettings(session.configSource, name));
+            const result = {
+                changed: tx.paths,
+                preserved: [`src/apps/${name}`],
+                ...(warnings.length ? { warnings } : {}),
+            };
             return await this.#finish(session, result, dryRun);
         }
         finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dokebi/cli",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": false,
   "publishConfig": {
     "access": "public",