sonamu 0.8.26 → 0.9.0

package/src/migration/code-generation.ts

@@ -1,14 +1,16 @@
 import equal from "fast-deep-equal";
-import type { Knex } from "knex";
+import { type Knex } from "knex";
 import { alphabetical, diff } from "radashi";
-import { EntityManager, Naite } from "..";
-import type {
-  EntityProp,
-  GenMigrationCode,
-  MigrationColumn,
-  MigrationForeign,
-  MigrationIndex,
-  MigrationSet,
+
+import { EntityManager } from "../entity/entity-manager";
+import { Naite } from "../naite/naite";
+import {
+  type EntityProp,
+  type GenMigrationCode,
+  type MigrationColumn,
+  type MigrationForeign,
+  type MigrationIndex,
+  type MigrationSet,
 } from "../types/types";
 import { isSearchTextProp } from "../types/types";
 import { formatCode } from "../utils/formatter";
@@ -468,7 +470,7 @@ function normalizeSearchTextExpressionNode(
         (name === "sonamu_text_array_agg" || name === "sonamu_jsonb_array_agg") &&
         args.length === 2 &&
         args[1]?.type === "boolean" &&
-        args[1].value === true
+        args[1].value
       ) {
         args = [args[0]];
       }
@@ -772,7 +774,7 @@ async function generateCreateCode_ColumnAndIndexes(
     table,
     type: "normal",
     title: `create__${table}`,
-    formatted: formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`),
+    formatted: await formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`),
   };
 }
 
@@ -1097,7 +1099,7 @@ async function generateCreateCode_Foreign(
       table,
       type: "foreign",
       title: `foreign__${table}__${foreignKeysString}`,
-      formatted: formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`),
+      formatted: await formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`),
     },
   ];
 }
@@ -1207,12 +1209,12 @@ async function generateAlterCode_ColumnAndIndexes(
   const recreatedSearchTextDbIndexes = dbIndexes.filter(
     (index) =>
       index.columns.some(({ name }) => recreatedSearchTextColumnNames.has(name)) &&
-      alterIndexesTo.drop.some((dropIndex) => dropIndex.name === index.name) === false,
+      !alterIndexesTo.drop.some((dropIndex) => dropIndex.name === index.name),
   );
   const recreatedSearchTextEntityIndexes = entityIndexes.filter(
     (index) =>
       index.columns.some(({ name }) => recreatedSearchTextColumnNames.has(name)) &&
-      alterIndexesTo.add.some((addIndex) => addIndex.name === index.name) === false,
+      !alterIndexesTo.add.some((addIndex) => addIndex.name === index.name),
   );
   const implicitlyDroppedDbIndexes = alterIndexesTo.drop.filter((index) =>
     index.columns.every(({ name }) => alterColumnsTo.drop.some((column) => column.name === name)),
@@ -1220,8 +1222,7 @@ async function generateAlterCode_ColumnAndIndexes(
 
   // 인덱스가 삭제되는 경우, 컬럼과 같이 삭제된 케이스에는 drop에서 제외해야함!
   const indexNeedsToDrop = alterIndexesTo.drop.filter(
-    (index) =>
-      implicitlyDroppedDbIndexes.some((droppedIndex) => droppedIndex.name === index.name) === false,
+    (index) => !implicitlyDroppedDbIndexes.some((droppedIndex) => droppedIndex.name === index.name),
   );
 
   // 빈 코드 생성 방지
@@ -1280,9 +1281,9 @@ async function generateAlterCode_ColumnAndIndexes(
     ...alterIndexesTo.add
       .filter(
         (index) =>
-          index.columns.every((indexCol) =>
+          !index.columns.every((indexCol) =>
             alterColumnsTo.add.map((col) => col.name).includes(indexCol.name),
-          ) === false,
+          ),
       )
       .map(genIndexDropDefinition),
   ];
@@ -1313,7 +1314,7 @@ async function generateAlterCode_ColumnAndIndexes(
     "}",
   ];
 
-  const formatted = formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`);
+  const formatted = await formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`);
   const title = [
     "alter",
     table,
@@ -1586,7 +1587,7 @@ export function getAlterIndexesTo(entityIndexes: MigrationIndex[], dbIndexes: Mi
   const identity = <T extends Record<string, unknown>>(index: T): string => {
     const keys = Object.keys(index)
       .filter((key) => key !== "name")
-      .sort();
+      .toSorted();
 
     return keys
       .map((key) => {
@@ -1596,7 +1597,7 @@ export function getAlterIndexesTo(entityIndexes: MigrationIndex[], dbIndexes: Mi
         if (key === "columns") {
           return (index[key] as MigrationIndex["columns"]).map((col) => {
             return Object.keys(col)
-              .sort()
+              .toSorted()
               .map((k) => `${k}=${col[k as keyof typeof col]}`)
               .join("//");
           });
@@ -1680,7 +1681,7 @@ async function generateAlterCode_Foreigns(
         return result;
       }
 
-      if (equal(entityF, matchingDbF) === false) {
+      if (!equal(entityF, matchingDbF)) {
         result.alterSrc.push(matchingDbF);
         result.alterDst.push(entityF);
         return result;
@@ -1758,7 +1759,7 @@ async function generateAlterCode_Foreigns(
     "}",
   ];
 
-  const formatted = formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`);
+  const formatted = await formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`);
   const title = ["alter", table, "foreigns"].join("_");
 
   return [
@@ -1888,7 +1889,7 @@ export async function generateAlterCode(
   }
 
   // 2. foreigns 처리 (삭제될 컬럼 정보 전달)
-  if (equal(entityForeigns, dbForeigns) === false) {
+  if (!equal(entityForeigns, dbForeigns)) {
     alterCodes.push(
       await generateAlterCode_Foreigns(
         entitySet.table,
@@ -2076,7 +2077,7 @@ async function generatePkTypeChangeMigration(
     "}",
   ];
 
-  const formatted = formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`);
+  const formatted = await formatCode(lines.join("\n"), "typescript", `src/migration/${table}.ts`);
 
   return [
     {

package/src/migration/migration-set.ts

@@ -1,8 +1,8 @@
 import inflection from "inflection";
-import type { Entity } from "../entity/entity";
+
+import { type Entity } from "../entity/entity";
 import { EntityManager } from "../entity/entity-manager";
 import {
-  type EntityProp,
   isBelongsToOneRelationProp,
   isHasManyRelationProp,
   isManyToManyRelationProp,
@@ -13,6 +13,9 @@ import {
   isStringProp,
   isVectorProp,
   isVirtualProp,
+} from "../types/types";
+import {
+  type EntityProp,
   type MigrationColumn,
   type MigrationColumnType,
   type MigrationForeign,
@@ -103,21 +106,16 @@ export function getMigrationSetFromEntity(entity: Entity): MigrationSetAndJoinTa
         const fields = [through.from, through.to];
         r.joinTables.push({
           table: through.from.split(".")[0],
-          indexes: [
-            // 조인 테이블에 걸린 인덱스 찾아와서 연결
-            ...entity.indexes
-              .filter((index) =>
-                index.columns.find((col) => col.name.includes(`${prop.joinTable}.`)),
-              )
-              .map((index) => ({
-                ...index,
-                columns: index.columns.map((col) => ({
-                  name: col.name.replace(`${prop.joinTable}.`, ""),
-                  nullsFirst: col.nullsFirst,
-                  sortOrder: col.sortOrder,
-                })),
+          indexes: entity.indexes
+            .filter((index) => index.columns.find((col) => col.name.includes(`${prop.joinTable}.`)))
+            .map((index) => ({
+              ...index,
+              columns: index.columns.map((col) => ({
+                name: col.name.replace(`${prop.joinTable}.`, ""),
+                nullsFirst: col.nullsFirst,
+                sortOrder: col.sortOrder,
               })),
-          ],
+            })),
           columns: [
             {
               name: "id",
@@ -187,7 +185,7 @@ export function getMigrationSetFromEntity(entity: Entity): MigrationSetAndJoinTa
               length: pkProp.length,
             }),
         });
-        if ((prop.useConstraint ?? true) === true) {
+        if (prop.useConstraint ?? true) {
           r.foreigns.push({
             columns: [idColumnName],
             to: `${inflection.underscore(inflection.pluralize(prop.with)).toLowerCase()}.id`,
@@ -210,7 +208,7 @@ export function getMigrationSetFromEntity(entity: Entity): MigrationSetAndJoinTa
 
   // indexes
   migrationSet.indexes = entity.indexes.filter((index) =>
-    index.columns.find((col) => col.name.includes(".") === false),
+    index.columns.find((col) => !col.name.includes(".")),
   );
 
   return migrationSet;

package/src/migration/migrator.ts

@@ -1,23 +1,26 @@
 import assert from "assert";
-import chalk from "chalk";
 import { mkdir, readdir, unlink, writeFile } from "fs/promises";
-import type { Knex } from "knex";
 import path from "path";
+
+import chalk from "chalk";
+import { type Knex } from "knex";
 import { group, sum, unique } from "radashi";
-import { Sonamu } from "../api";
-import { DB, type SonamuDBConfig } from "../database/db";
+
+import { Sonamu } from "../api/sonamu";
+import { DB } from "../database/db";
+import { type SonamuDBConfig } from "../database/db";
 import { createKnexInstance } from "../database/knex";
 import { SD } from "../dict/sd";
 import { EntityManager } from "../entity/entity-manager";
 import { ServiceUnavailableException } from "../exceptions/so-exceptions";
 import { Naite } from "../naite/naite";
-import type { GenMigrationCode, MigrationSet } from "../types/types";
+import { type GenMigrationCode, type MigrationSet } from "../types/types";
 import { isTest } from "../utils/controller";
 import { exists } from "../utils/fs-utils";
 import { generateAlterCode, generateCreateCode } from "./code-generation";
 import { getMigrationSetFromEntity } from "./migration-set";
 import { PostgreSQLSchemaReader } from "./postgresql-schema-reader";
-import type { ConnString, MigrationCode, MigrationStatus } from "./types";
+import { type ConnString, type MigrationCode, type MigrationStatus } from "./types";
 
 export type MigrationResult = {
   connKey: string;
@@ -26,6 +29,26 @@ export type MigrationResult = {
 }[];
 
 export class Migrator {
+  private async runMigrationsSequentially(
+    conns: { connKey: keyof SonamuDBConfig; knex: Knex }[],
+    action: "apply" | "rollback",
+  ): Promise<MigrationResult> {
+    const results: MigrationResult = [];
+
+    for (const { connKey, knex } of conns) {
+      const [batchNo, applied] =
+        action === "apply" ? await knex.migrate.latest() : await knex.migrate.rollback();
+
+      results.push({
+        connKey,
+        batchNo,
+        applied,
+      });
+    }
+
+    return results;
+  }
+
   private async getMigrationCodes(): Promise<MigrationCode[]> {
     const srcMigrationsDir = path.join(Sonamu.apiRootPath, "src", "migrations"); // 이건 환경에 관계없이 항상 src에서 찾아야 해요.
 
@@ -41,7 +64,7 @@ export class Migrator {
         name: f.replace(".ts", ""),
         path: path.join(srcMigrationsDir, f),
       }))
-      .sort((a, b) => (a.name < b.name ? 1 : -1)); // 이름 내림차순 정렬(최신순)
+      .toSorted((a, b) => (a.name < b.name ? 1 : -1)); // 이름 내림차순 정렬(최신순)
 
     Naite.t("migrator:getMigrationCodes:results", codes);
     return codes;
@@ -61,7 +84,7 @@ export class Migrator {
     Naite.t("migrator:getStatus:codes", codes);
 
     const connKeys = Object.keys(Sonamu.dbConfig).filter(
-      (key) => key.endsWith("_slave") === false,
+      (key) => !key.endsWith("_slave"),
     ) as (keyof typeof Sonamu.dbConfig)[];
 
     let migrationStatusError: string | undefined;
@@ -72,7 +95,7 @@ export class Migrator {
         const tConn = createKnexInstance(knexOptions);
 
         try {
-          const status = await (async () => {
+          const status: number | "error" = await (async () => {
             try {
               return await tConn.migrate.status();
             } catch (err) {
@@ -94,7 +117,7 @@ export class Migrator {
               return [];
             }
           })();
-          const currentVersion = await (async () => {
+          const currentVersion: string | "error" = await (async () => {
             try {
               return await tConn.migrate.currentVersion();
             } catch (_err) {
@@ -113,7 +136,7 @@ export class Migrator {
               connection.port
             }/${connection.database}` as ConnString,
             currentVersion,
-            status: status as number | "error",
+            status: status,
             pending,
           };
         } finally {
@@ -175,7 +198,7 @@ export class Migrator {
       targets
         .map((target) => ({
           connKey: target,
-          options: Sonamu.dbConfig[target as keyof typeof Sonamu.dbConfig],
+          options: Sonamu.dbConfig[target],
         }))
         .filter((c) => c.options !== undefined),
       ({ options }) =>
@@ -197,27 +220,9 @@ export class Migrator {
       const result = await (async () => {
         switch (action) {
           case "apply":
-            return Promise.all(
-              conns.map(async ({ connKey, knex }) => {
-                const [batchNo, applied] = await knex.migrate.latest();
-                return {
-                  connKey,
-                  batchNo,
-                  applied, // 이번 latest 호출로 인해 "up"이 적용된 마이그레이션 이름(e.g. "20251124233557_create__companies.ts")들의 배열입니다. 참고: https://github.com/knex/knex/blob/01b177c485d696f1b72858dee728ba143c4fad76/lib/migrations/migrate/Migrator.js#L560
-                };
-              }),
-            );
+            return this.runMigrationsSequentially(conns, "apply");
           case "rollback":
-            return Promise.all(
-              conns.map(async ({ connKey, knex }) => {
-                const [batchNo, applied] = await knex.migrate.rollback();
-                return {
-                  connKey,
-                  batchNo,
-                  applied, // 이번 rollback 호출로 인해 "down"이 적용된(=롤백된) 마이그레이션 이름(e.g. "20251124233557_create__companies.ts")들의 배열입니다. 참고: https://github.com/knex/knex/blob/01b177c485d696f1b72858dee728ba143c4fad76/lib/migrations/migrate/Migrator.js#L611
-                };
-              }),
-            );
+            return this.runMigrationsSequentially(conns, "rollback");
         }
       })();
 
@@ -242,7 +247,7 @@ export class Migrator {
    */
   validateDeletable(conns: MigrationStatus["conns"], codeNames: string[]) {
     const appliedCodes = codeNames.filter((codeName) =>
-      conns.some((conn) => conn.pending.includes(codeName) === false),
+      conns.some((conn) => !conn.pending.includes(codeName)),
     );
 
     return {

package/src/migration/postgresql-schema-reader.ts

@@ -1,12 +1,14 @@
 import assert from "assert";
-import type { Knex } from "knex";
+
+import { type Knex } from "knex";
 import { group } from "radashi";
-import type {
-  MigrationColumn,
-  MigrationForeign,
-  MigrationIndex,
-  MigrationSet,
-  RelationOn,
+
+import {
+  type MigrationColumn,
+  type MigrationForeign,
+  type MigrationIndex,
+  type MigrationSet,
+  type RelationOn,
 } from "../types/types";
 
 /**
@@ -413,11 +415,9 @@ class PostgreSQLSchemaReaderClass {
     }
 
     if (type === "ivfflat") {
-      return {
-        ...(this.parseIntegerOption(withOptions.lists) !== undefined
-          ? { lists: this.parseIntegerOption(withOptions.lists) }
-          : {}),
-      };
+      return this.parseIntegerOption(withOptions.lists) !== undefined
+        ? { lists: this.parseIntegerOption(withOptions.lists) }
+        : {};
     }
 
     return {};

package/src/migration/slack-confirm.ts

@@ -3,10 +3,11 @@ import crypto from "crypto";
 import fs from "fs/promises";
 import os from "os";
 import path from "path";
-import { Sonamu } from "../api";
-import type { SonamuDBConfig } from "../database/db";
+
+import { Sonamu } from "../api/sonamu";
+import { type SonamuDBConfig } from "../database/db";
 import { SD } from "../dict/sd";
-import type { MigrationResult } from "./migrator";
+import { type MigrationResult } from "./migrator";
 
 export type SlackConfirmResult = {
   status: "approved" | "rejected" | "pending" | "not_configured" | "error";
@@ -42,7 +43,7 @@ export class SlackConfirm {
    * 마이그레이션 목록의 해시를 생성합니다.
    */
   getMigrationsHash(migrations: string[]): string {
-    const sorted = [...migrations].sort();
+    const sorted = [...migrations].toSorted();
     return crypto.createHash("md5").update(sorted.join(",")).digest("hex").slice(0, 12);
   }
 

package/src/migration/types.ts

@@ -1,5 +1,5 @@
-import type { SonamuDBConfig } from "../database/db";
-import type { GenMigrationCode } from "../types/types";
+import { type SonamuDBConfig } from "../database/db";
+import { type GenMigrationCode } from "../types/types";
 
 export type MigrationCode = {
   name: string;

package/src/naite/messaging-types.ts

@@ -1,4 +1,4 @@
-// biome-ignore-all lint/suspicious/noExplicitAny: Naite는 expect와 호응하도록 any를 허용함
+/* oxlint-disable @typescript-eslint/no-explicit-any */ // Naite는 expect와 호응하도록 any를 허용함
 
 /**
  * Sonamu extension과 공유하는 Naite 메시징 관련 타입 정의들입니다.

package/src/naite/naite-reporter.ts

@@ -8,14 +8,16 @@
  *
  * fs mock 충돌을 피하기 위해 net 모듈만 사용합니다.
  */
-/** biome-ignore-all lint/suspicious/noExplicitAny: Naite는 expect와 호응하도록 any를 허용함 */
+/* oxlint-disable @typescript-eslint/no-explicit-any */ // Naite는 expect와 호응하도록 any를 허용함
 
 import { createHash } from "crypto";
-import { connect, type Socket } from "net";
+import { connect } from "net";
+import { type Socket } from "net";
 import { homedir } from "os";
 import { join } from "path";
+
 import { findApiRootPath } from "../utils/utils";
-import type { NaiteMessagingTypes } from "./messaging-types";
+import { type NaiteMessagingTypes } from "./messaging-types";
 
 /**
  * sonamu.config.ts 경로를 받아서 프로젝트별 고유 해시를 생성합니다.

package/src/naite/naite.ts

@@ -1,9 +1,10 @@
-/** biome-ignore-all lint/suspicious/noExplicitAny: Naite는 expect와 호응하도록 any를 허용함 */
+/* oxlint-disable @typescript-eslint/no-explicit-any */ // Naite는 expect와 호응하도록 any를 허용함
 
 import { getLogger } from "@logtape/logtape";
 import { get } from "radashi";
+
 import { Sonamu } from "../api/sonamu";
-import type { ComparisonOperator } from "../database/puri.types";
+import { type ComparisonOperator } from "../database/puri.types";
 import { convertNaiteKeyToCategory } from "../logger/category";
 import { isSerializable } from "../utils/object-utils";
 
@@ -142,6 +143,10 @@ function matchesPattern(key: string, pattern: string): boolean {
 export class NaiteQuery {
   constructor(private traces: NaiteTrace[]) {}
 
+  private isComparableValue(value: unknown): value is number | string {
+    return typeof value === "number" || typeof value === "string";
+  }
+
   /**
    * 파일명으로 필터링
    * @param fileName 파일명 (예: "syncer.test.ts")
@@ -185,17 +190,17 @@ export class NaiteQuery {
    */
   where(path: string, operator: ComparisonOperator | "includes", value: any): NaiteQuery {
     const filtered = this.traces.filter((trace) => {
-      const actual = get(trace, path) as any;
+      const actual = get(trace, path);
 
       switch (operator) {
         case ">":
-          return actual > value;
+          return this.isComparableValue(actual) && this.isComparableValue(value) && actual > value;
         case "<":
-          return actual < value;
+          return this.isComparableValue(actual) && this.isComparableValue(value) && actual < value;
         case ">=":
-          return actual >= value;
+          return this.isComparableValue(actual) && this.isComparableValue(value) && actual >= value;
         case "<=":
-          return actual <= value;
+          return this.isComparableValue(actual) && this.isComparableValue(value) && actual <= value;
         case "=":
           return actual === value;
         case "!=":

package/src/shared/app.shared.ts.txt

@@ -3,8 +3,8 @@
  * 최초 1회 생성되며, 이후에는 덮어쓰지 않습니다.
  * 필요시 직접 수정할 수 있습니다.
  */
-/** biome-ignore-all lint/correctness/useExhaustiveDependencies: shared */
-/** biome-ignore-all lint/suspicious/noExplicitAny: shared */
+/* oxlint-disable react-hooks/exhaustive-deps */ // shared
+/* oxlint-disable @typescript-eslint/no-explicit-any */ // shared
 
 /*
   fetch

package/src/shared/web.shared.ts.txt

@@ -3,8 +3,8 @@
  * 최초 1회 생성되며, 이후에는 덮어쓰지 않습니다.
  * 필요시 직접 수정할 수 있습니다.
  */
-/** biome-ignore-all lint/correctness/useExhaustiveDependencies: shared */
-/** biome-ignore-all lint/suspicious/noExplicitAny: shared */
+/* oxlint-disable react-hooks/exhaustive-deps */ // shared
+/* oxlint-disable @typescript-eslint/no-explicit-any */ // shared
 
 /*
   fetch

package/src/skills/AGENTS.md

@@ -23,6 +23,7 @@ When working in a user Sonamu project, always read skill files directly using th
 ```
 
 Examples:
+
 - Migration → Read `.claude/skills/sonamu/migration.md`
 - Entity creation → Read `.claude/skills/sonamu/entity-basic.md`
 - Full workflow → Read `.claude/skills/sonamu/workflow.md`
@@ -61,21 +62,21 @@ Do not skip biome check even when tsc passes. Biome catches `noNonNullAssertion`
 
 Read the listed skill file before attempting any workaround or fix in these situations:
 
-| Situation | Read before acting |
-|-----------|-------------------|
-| TypeScript error in Model code (type inference, "excessively deep", etc.) | `puri.md`, `model.md` |
-| Writing or modifying a `findMany()` / `executeSubsetQuery()` call | `model.md` |
-| Writing or modifying a `@upload` method | `api.md` |
-| Database query returning unexpected results | `puri.md` |
-| Migration error or schema change | `migration.md` |
-| Starting AC+Claim-based development or writing a Claim | `cdd.md` |
-| Applying Auth Guards or handling session/permission logic | `auth.md` |
-| Implementing polymorphic relations with `entity_type` + `entity_id` pattern | `entity-relations.md` |
-| Writing Puri SELECT / WHERE / JOIN / FTS / pgvector queries | `puri.md` |
-| Implementing `@upload` file upload or deciding parameter pattern | `api.md`, `framework-change.md` |
-| Reading or writing files under `contract/rules/` | `cdd.md` |
-| Implementing `BaseAgentClass` or `@tools` decorator | `ai-agents.md` |
-| Implementing background jobs or cron scheduling | `tasks.md` |
-| Batch-saving relation data (upsert) | `upsert.md` |
-| Adding a new entity or enum and registering i18n keys | `i18n.md` |
-| Implementing pgvector embeddings or vector search | `vector.md` |
+| Situation                                                                   | Read before acting              |
+| --------------------------------------------------------------------------- | ------------------------------- |
+| TypeScript error in Model code (type inference, "excessively deep", etc.)   | `puri.md`, `model.md`           |
+| Writing or modifying a `findMany()` / `executeSubsetQuery()` call           | `model.md`                      |
+| Writing or modifying a `@upload` method                                     | `api.md`                        |
+| Database query returning unexpected results                                 | `puri.md`                       |
+| Migration error or schema change                                            | `migration.md`                  |
+| Starting AC+Claim-based development or writing a Claim                      | `cdd.md`                        |
+| Applying Auth Guards or handling session/permission logic                   | `auth.md`                       |
+| Implementing polymorphic relations with `entity_type` + `entity_id` pattern | `entity-relations.md`           |
+| Writing Puri SELECT / WHERE / JOIN / FTS / pgvector queries                 | `puri.md`                       |
+| Implementing `@upload` file upload or deciding parameter pattern            | `api.md`, `framework-change.md` |
+| Reading or writing files under `contract/rules/`                            | `cdd.md`                        |
+| Implementing `BaseAgentClass` or `@tools` decorator                         | `ai-agents.md`                  |
+| Implementing background jobs or cron scheduling                             | `tasks.md`                      |
+| Batch-saving relation data (upsert)                                         | `upsert.md`                     |
+| Adding a new entity or enum and registering i18n keys                       | `i18n.md`                       |
+| Implementing pgvector embeddings or vector search                           | `vector.md`                     |

package/src/skills/commands/sonamu-skills.md

@@ -3,18 +3,18 @@ Read ~/.claude/skills/sonamu/SKILL.md and follow its instructions.
 Then greet the user with the following format (exactly):
 
 ---
+
 Sonamu 스킬 가이드가 로드됐습니다. 어떤 작업을 하실 건가요?
 
-**Workflow**  · CDD · project-init · config
+**Workflow** · CDD · project-init · config
 **Entity/DB** · entity-basic · entity-relations · subset · migration · database
-**API**       · model · api · puri · upsert
-**Testing**   · testing · devrunner · naite · cone · fixture-cli
-**Auth**      · auth · auth-migration · auth-plugins
-**Frontend**  · frontend · scaffolding · i18n
-**Advanced**  · vector · ai-agents · tasks
-**Meta**      · skill-contribution · framework-change
+**API** · model · api · puri · upsert
+**Testing** · testing · devrunner · naite · cone · fixture-cli
+**Auth** · auth · auth-migration · auth-plugins
+**Frontend** · frontend · scaffolding · i18n
+**Advanced** · vector · ai-agents · tasks
+**Meta** · skill-contribution · framework-change
 
-어떤 스킬이나 작업을 도와드릴까요? (하고 싶은 작업을 자유롭게 설명해도 됩니다.)
----
+## 어떤 스킬이나 작업을 도와드릴까요? (하고 싶은 작업을 자유롭게 설명해도 됩니다.)
 
 If the user provides $ARGUMENTS, skip the greeting and directly help with: $ARGUMENTS