sonamu 0.8.26 → 0.9.0

package/src/skills/sonamu/scaffolding.md

@@ -9,13 +9,13 @@ description: Reference for using Sonamu UI Scaffolding. Common errors and soluti
 
 **The following 5 items must all be scaffolded for every entity:**
 
-| Item | Description |
-|------|------|
-| `model` | CRUD model based on BaseModelClass |
-| `model_test` | Model test file |
-| `view_list` | List view component |
-| `view_search_input` | Search input component |
-| `view_form` | Create/edit form component |
+| Item                | Description                        |
+| ------------------- | ---------------------------------- |
+| `model`             | CRUD model based on BaseModelClass |
+| `model_test`        | Model test file                    |
+| `view_list`         | List view component                |
+| `view_search_input` | Search input component             |
+| `view_form`         | Create/edit form component         |
 
 **DO NOT:** scaffold only model and model_test and skip the view-related items
 
@@ -36,6 +36,7 @@ Run from the **`packages/api`** directory:
 **CRITICAL: After scaffolding is complete, you must perform the following steps.**
 
 ### 1. Build Test
+
 ```bash
 cd packages/api
 pnpm build
@@ -43,14 +44,17 @@ pnpm build
 cd packages/web
 pnpm build
 ```
+
 - [ ] API build succeeds
 - [ ] Web build succeeds
 
 ### 2. Restart Dev Server
+
 ```bash
 cd packages/api
 pnpm dev
 ```
+
 - [ ] Server running normally
 
 ### 3. If Relations Exist (Add i18n Keys)
@@ -61,19 +65,20 @@ pnpm dev
 // packages/api/src/i18n/ko.ts
 export default {
   // ... existing keys
-  
+
   // Add for each entity with relations
   "entity.Post.author_id": "Author",
   "entity.Question.collection_id": "Collection",
   "entity.Question.parent_id": "Parent Question",
   "entity.Employee.department_id": "Department",
   "entity.Task.principal_investigator_id": "Principal Investigator",
-  
+
   // ...
 } as const;
 ```
 
 **Pattern**: `entity.{EntityId}.{relation}_id`
+
 - Add `_id` suffix to the relation name
 - Example: `author` relation → `author_id` key
 
@@ -90,7 +95,7 @@ export default {
 if (params.orderBy === "id-desc") {
   qb.orderBy("posts.id", "desc");
 } else {
-  exhaustive(params.orderBy);  // type error!
+  exhaustive(params.orderBy); // type error!
 }
 
 // Fix: add the remaining cases
@@ -101,7 +106,7 @@ if (params.orderBy === "id-desc") {
 } else if (params.orderBy === "name-asc") {
   qb.orderBy("posts.name", "asc");
 } else {
-  exhaustive(params.orderBy);  // no more type errors
+  exhaustive(params.orderBy); // no more type errors
 }
 ```
 
@@ -121,19 +126,17 @@ export const PostSaveParams = PostBaseSchema.partial({
 });
 
 // Fix: add nullable fields
-export const PostSaveParams = PostBaseSchema
-  .partial({
-    id: true,
-    created_at: true,
-    updated_at: true,      // nullable field
-    category: true,        // nullable field
-    description: true,     // nullable field
-  })
-  .extend({
-    updated_at: z.date().nullish(),
-    category: z.string().nullish(),
-    description: z.string().nullish(),
-  });
+export const PostSaveParams = PostBaseSchema.partial({
+  id: true,
+  created_at: true,
+  updated_at: true, // nullable field
+  category: true, // nullable field
+  description: true, // nullable field
+}).extend({
+  updated_at: z.date().nullish(),
+  category: z.string().nullish(),
+  description: z.string().nullish(),
+});
 ```
 
 **Detailed guide**: See "Tasks to do immediately after entity creation" in `testing.md`
@@ -154,12 +157,12 @@ Post-scaffolding required checklist complete
 
 ## Common Errors
 
-| Error | Cause | Fix |
-|------|------|------|
-| "Non-existent module path requested {Type}" | types.ts not created or not compiled | Wait/create manually → build → restart dev |
-| exhaustive() type error | Only the first OrderBy value is handled automatically | See "4. Add OrderBy Cases" above |
-| Missing i18n key (relation) | `author_id` vs `author` | See "3. If Relations Exist" above |
-| IdAsyncSelect API mismatch | Old scaffolding template used | See "IdAsyncSelect API Migration" below |
+| Error                                       | Cause                                                 | Fix                                        |
+| ------------------------------------------- | ----------------------------------------------------- | ------------------------------------------ |
+| "Non-existent module path requested {Type}" | types.ts not created or not compiled                  | Wait/create manually → build → restart dev |
+| exhaustive() type error                     | Only the first OrderBy value is handled automatically | See "4. Add OrderBy Cases" above           |
+| Missing i18n key (relation)                 | `author_id` vs `author`                               | See "3. If Relations Exist" above          |
+| IdAsyncSelect API mismatch                  | Old scaffolding template used                         | See "IdAsyncSelect API Migration" below    |
 
 ## Detailed Explanations
 
@@ -194,14 +197,17 @@ if (entityId) {
 ```
 
 **Auto-generation conditions**:
+
 - When `parentId` is absent (top-level entity)
 - When the `types.ts` file does not yet exist
 
 **Causes of errors**:
+
 - Attempting scaffolding immediately after entity creation before the syncer has run
 - types.ts was created but the build has not completed so the `.js` file is missing
 
 **Resolution order** (run from `packages/api`):
+
 1. Wait briefly after entity creation for the syncer to generate types.ts (2-3 seconds)
 2. If types.ts is missing, create it manually (see template below)
 3. Create migration (Sonamu UI) and run it (`pnpm sonamu migrate run`)
@@ -256,7 +262,7 @@ The scaffolding template only handles the **first value** of the `OrderBy` enum
 if (params.orderBy === "id-desc") {
   qb.orderBy("posts.id", "desc");
 } else {
-  exhaustive(params.orderBy);  // remaining cases unhandled → type error
+  exhaustive(params.orderBy); // remaining cases unhandled → type error
 }
 ```
 
@@ -288,6 +294,7 @@ An entity's relation prop is defined as `author`, and the i18n label in `sd.gene
 **Fix (choose one)**:
 
 1. **Manually add `_id` key to ko.ts** (recommended):
+
 ```typescript
 // packages/api/src/i18n/ko.ts
 export default {
@@ -300,9 +307,12 @@ export default {
 ```
 
 2. **Remove `_id` from form.tsx** (requires manual edit):
+
 ```typescript
 // Manual edit after scaffolding
-{SD("entity.Post.author")}  // remove _id
+{
+  SD("entity.Post.author");
+} // remove _id
 ```
 
 **Recommended**: First option - add the `_id` key to ko.ts. It is preserved during sync and can be reused across multiple forms.
@@ -318,6 +328,7 @@ Therefore, running `pnpm sonamu scaffold` generates wrapper components based on
 #### Specific API Changes
 
 **Old API (code generated by scaffolding):**
+
 ```typescript
 export function UserIdAsyncSelect<T extends UserSubsetKey>({
   subset,
@@ -350,6 +361,7 @@ export function UserIdAsyncSelect<T extends UserSubsetKey>({
 ```
 
 **New API (actual package API):**
+
 ```typescript
 export function UserIdAsyncSelect<T extends UserSubsetKey>({
   subset,

package/src/skills/sonamu/skill-contribution.md

@@ -11,9 +11,9 @@ The process for capturing knowledge from a resolved troubleshooting session into
 
 ## Triggers
 
-| Trigger | Owner | Example |
-|---------|-------|---------|
-| **Explicit request** | User | "Document this in skills", "Record this fix" |
+| Trigger              | Owner | Example                                                                        |
+| -------------------- | ----- | ------------------------------------------------------------------------------ |
+| **Explicit request** | User  | "Document this in skills", "Record this fix"                                   |
 | **Agent suggestion** | Agent | When a detection pattern below is met, propose: "Should I add this to skills?" |
 
 ### Agent detection patterns
@@ -25,6 +25,7 @@ Suggest contribution when the following flow is observed in the conversation:
 3. The same problem is **likely to occur in other projects or for other users**
 
 Do not suggest when:
+
 - Simple typos or missing imports
 - Project-specific business logic bugs
 - One-off environment issues (e.g., port conflict on a specific machine)
@@ -52,22 +53,22 @@ Summarize from the conversation using the following structure:
 symptom: "one-line description (error message or observed behavior)"
 cause: "explanation of root cause"
 solution: "resolution steps (include specific commands/code)"
-source_paths:         # related source file paths
+source_paths: # related source file paths
   - "src/testing/dev-vitest-manager.ts"
-tags:                 # keywords for matching
+tags: # keywords for matching
   - "testing"
   - "devrunner"
-scope: "sonamu"       # "sonamu" (framework-level) or "local" (project-specific)
+scope: "sonamu" # "sonamu" (framework-level) or "local" (project-specific)
 ```
 
 ### Scope decision criteria
 
-| Condition | scope |
-|-----------|-------|
-| Relates to Sonamu framework behavior or constraints | `sonamu` |
-| Relates to Sonamu CLI, config, migration, or shared tooling | `sonamu` |
-| Relates to a specific project's business logic or configuration | `local` |
-| Unclear | Ask the user |
+| Condition                                                       | scope        |
+| --------------------------------------------------------------- | ------------ |
+| Relates to Sonamu framework behavior or constraints             | `sonamu`     |
+| Relates to Sonamu CLI, config, migration, or shared tooling     | `sonamu`     |
+| Relates to a specific project's business logic or configuration | `local`      |
+| Unclear                                                         | Ask the user |
 
 ---
 
@@ -77,30 +78,30 @@ scope: "sonamu"       # "sonamu" (framework-level) or "local" (project-specific)
 
 ### Match priority
 
-| Priority | Method | Description |
-|----------|--------|-------------|
-| 1 | **Source paths** | Check whether `source_paths` overlap with source references in existing skills |
-| 2 | **Tags/keywords** | Compare against each skill's YAML `description` and tags |
-| 3 | **SKILL.md task table** | Cross-reference which task row maps to the problem domain |
+| Priority | Method                  | Description                                                                    |
+| -------- | ----------------------- | ------------------------------------------------------------------------------ |
+| 1        | **Source paths**        | Check whether `source_paths` overlap with source references in existing skills |
+| 2        | **Tags/keywords**       | Compare against each skill's YAML `description` and tags                       |
+| 3        | **SKILL.md task table** | Cross-reference which task row maps to the problem domain                      |
 
 ### Source path → skill mapping (key paths)
 
-| Source path pattern | Corresponding skill |
-|---------------------|---------------------|
-| `src/testing/*` | testing.md, testing-devrunner.md, naite.md, fixture-cli.md |
-| `src/database/puri*` | puri.md |
-| `src/database/migrator*` | migration.md |
-| `src/auth/*` | auth.md, auth-plugins.md, auth-migration.md |
-| `src/entity/*`, `src/syncer/*` | entity-basic.md, entity-relations.md |
-| `src/vector/*` | vector.md |
-| `src/ai/agents/*` | ai-agents.md |
-| `src/naite/*` | naite.md |
-| `src/cone/*` | cone.md |
-| `src/api/*` | api.md |
-| `src/template/*` | framework-change.md |
-| `src/model/*` | model.md |
-| `src/ssr/*` | (no skill — candidate for new file) |
-| `sonamu.config.ts` related | config.md |
+| Source path pattern            | Corresponding skill                                        |
+| ------------------------------ | ---------------------------------------------------------- |
+| `src/testing/*`                | testing.md, testing-devrunner.md, naite.md, fixture-cli.md |
+| `src/database/puri*`           | puri.md                                                    |
+| `src/database/migrator*`       | migration.md                                               |
+| `src/auth/*`                   | auth.md, auth-plugins.md, auth-migration.md                |
+| `src/entity/*`, `src/syncer/*` | entity-basic.md, entity-relations.md                       |
+| `src/vector/*`                 | vector.md                                                  |
+| `src/ai/agents/*`              | ai-agents.md                                               |
+| `src/naite/*`                  | naite.md                                                   |
+| `src/cone/*`                   | cone.md                                                    |
+| `src/api/*`                    | api.md                                                     |
+| `src/template/*`               | framework-change.md                                        |
+| `src/model/*`                  | model.md                                                   |
+| `src/ssr/*`                    | (no skill — candidate for new file)                        |
+| `sonamu.config.ts` related     | config.md                                                  |
 
 If the path is not in this table, fall through to tag/keyword matching.
 
@@ -114,13 +115,13 @@ If the path is not in this table, fall through to tag/keyword matching.
 
 ## [3] Decide
 
-| Match result | Decision | Description |
-|--------------|----------|-------------|
-| **Same content exists** in an existing skill | **SKIP** | Report: "Already documented in {skill}.md" |
-| Match found + skill has **troubleshooting section** | **APPEND** | Add item to existing section |
+| Match result                                           | Decision        | Description                                  |
+| ------------------------------------------------------ | --------------- | -------------------------------------------- |
+| **Same content exists** in an existing skill           | **SKIP**        | Report: "Already documented in {skill}.md"   |
+| Match found + skill has **troubleshooting section**    | **APPEND**      | Add item to existing section                 |
 | Match found + skill has **no troubleshooting section** | **ADD_SECTION** | Add a new troubleshooting section at the end |
-| No match + scope=`sonamu` | **NEW_FILE** | Create a new skill file (rare) |
-| No match + scope=`local` | **LOCAL** | Create in `.claude/skills/local/` |
+| No match + scope=`sonamu`                              | **NEW_FILE**    | Create a new skill file (rare)               |
+| No match + scope=`local`                               | **LOCAL**       | Create in `.claude/skills/local/`            |
 
 **CRITICAL: APPEND and ADD_SECTION should account for the vast majority of cases.** NEW_FILE is only for when the content genuinely does not fit anywhere in the existing skills.
 
@@ -136,6 +137,7 @@ Use the pattern from `testing-devrunner.md` as the standard:
 ## Troubleshooting
 
 ### "Error message or one-line symptom"
+
 → Explanation of root cause
 → Fix: specific resolution (commands / code / config)
 ```
@@ -148,6 +150,7 @@ Adding to cone.md:
 
 ```markdown
 ### "pnpm sonamu cone gen --all fails with 'ANTHROPIC_API_KEY is not set'"
+
 → Key is missing from .env or was set only in root .env rather than packages/api/.env
 → Fix: add `ANTHROPIC_API_KEY=sk-ant-...` to `packages/api/.env`
 ```
@@ -162,6 +165,7 @@ Adding a new section at the end of puri.md:
 ## Troubleshooting
 
 ### "nullable field type inferred as non-null after leftJoin"
+
 → Puri type inference does not account for join direction. leftJoin results may be null at runtime but are not reflected as optional in the types.
 → Fix: explicitly mark the field as optional in the subset, or add a null check at the call site
 ```
@@ -181,6 +185,7 @@ description: Deployment notes for the KOPRI project. Use when deploying KOPRI pr
 ## Troubleshooting
 
 ### "sharp package installation fails during Docker build"
+
 → Alpine image is missing native dependencies for sharp
 → Fix: add `RUN apk add --no-cache vips-dev` to Dockerfile
 ```
@@ -212,13 +217,13 @@ Shall I apply this?
 
 ## [6] Apply
 
-| Decision | Action |
-|----------|--------|
-| SKIP | None |
-| APPEND | Add `###` entry to the troubleshooting section in the skill |
+| Decision    | Action                                                                                                                                 |
+| ----------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| SKIP        | None                                                                                                                                   |
+| APPEND      | Add `###` entry to the troubleshooting section in the skill                                                                            |
 | ADD_SECTION | Add `## Troubleshooting` section + entry at the end of the skill (just before `## References` if it exists, otherwise at the very end) |
-| NEW_FILE | Create new .md file + **register in both tables in SKILL.md** |
-| LOCAL | Create `.claude/skills/local/{name}.md` |
+| NEW_FILE    | Create new .md file + **register in both tables in SKILL.md**                                                                          |
+| LOCAL       | Create `.claude/skills/local/{name}.md`                                                                                                |
 
 ### ADD_SECTION insertion position
 

package/src/skills/sonamu/subset.md

@@ -6,6 +6,7 @@ description: Define API response field scope with Sonamu Subsets. Include relati
 # Subset Definition
 
 **Working code references:**
+
 - `sonamu/examples/miomock/api/src/application/project/project.entity.json` - complex Subset example
 - `sonamu/examples/miomock/api/src/application/employee/employee.entity.json` - basic Subset example
 
@@ -25,18 +26,19 @@ description: Define API response field scope with Sonamu Subsets. Include relati
 
 **WARNING: Only use A, P, and SS as Subset names. Do not use arbitrary names like S, D, or L.**
 
-| Subset | Purpose |
-|--------|---------|
-| `A` | All - all fields (detail view, admin). **Required** |
-| `P` | Partial/Profile - partial fields including relations (for list views) |
-| `SS` | Super Simple/Summary - minimal fields, just ID + name (for dropdowns, selects) |
-| `P2`, `P3` | Additional profiles (only for special cases) |
+| Subset     | Purpose                                                                        |
+| ---------- | ------------------------------------------------------------------------------ |
+| `A`        | All - all fields (detail view, admin). **Required**                            |
+| `P`        | Partial/Profile - partial fields including relations (for list views)          |
+| `SS`       | Super Simple/Summary - minimal fields, just ID + name (for dropdowns, selects) |
+| `P2`, `P3` | Additional profiles (only for special cases)                                   |
 
 ### IMPORTANT: Subset A Must Include All Fields
 
 **Subset A must include all regular fields and major relation fields of the Entity.**
 
 **DO:**
+
 ```json
 {
   "props": [
@@ -53,15 +55,17 @@ description: Define API response field scope with Sonamu Subsets. Include relati
 ```
 
 **DO NOT:**
+
 ```json
 {
   "subsets": {
-    "A": ["id", "title"]  // created_at, status, author omitted - incorrect
+    "A": ["id", "title"] // created_at, status, author omitted - incorrect
   }
 }
 ```
 
 **Rules:**
+
 - Include all regular fields (id, created_at, business fields, etc.)
 - For BelongsToOne relations, include at least `.id` and a display field (`.name`, `.title`, etc.)
 - HasMany relations are optional (include only when needed)
@@ -92,12 +96,7 @@ description: Define API response field scope with Sonamu Subsets. Include relati
 ```json
 {
   "subsets": {
-    "P": [
-      "id",
-      "username",
-      "employee.salary",
-      "employee.department.name"
-    ]
+    "P": ["id", "username", "employee.salary", "employee.department.name"]
   }
 }
 ```
@@ -162,5 +161,6 @@ const result = await UserModel.executeSubsetQuery({
 ```
 
 **Working code references:**
+
 - `sonamu/examples/miomock/api/src/application/project/project.entity.json` - Subset definition examples
 - `sonamu/examples/miomock/api/src/application/employee/employee.entity.json` - BelongsToOne relation examples

package/src/skills/sonamu/tasks.md

@@ -8,6 +8,7 @@ description: Sonamu Tasks workflow system. Background jobs, scheduling, durable
 PostgreSQL-based durable workflow engine. Uses the `@sonamu-kit/tasks` package.
 
 **Source code:**
+
 - Decorator: `modules/sonamu/src/tasks/decorator.ts`
 - StepWrapper: `modules/sonamu/src/tasks/step-wrapper.ts`
 - WorkflowManager: `modules/sonamu/src/tasks/workflow-manager.ts`
@@ -28,31 +29,34 @@ export const myTask = workflow({
 });
 
 // Method 2: decorator + function inlined
-export const myTask = workflow({
-  version: "1",
-}, async ({ input, step, logger, version }) => {
-  // ...
-});
+export const myTask = workflow(
+  {
+    version: "1",
+  },
+  async ({ input, step, logger, version }) => {
+    // ...
+  },
+);
 ```
 
 ### DefineWorkflowOptions
 
-| Option | Type | Required | Description |
-|------|------|------|------|
-| `version` | `string` | Y | Workflow version (distinguishes from existing runs when changed) |
-| `name` | `string` | N | Workflow name (default: function name converted to underscore case) |
-| `schema` | `StandardSchemaV1` | N | Input validation schema (Zod, etc.) |
-| `schedules` | `Schedule[]` | N | Array of cron schedules |
-| `retryPolicy` | `RetryPolicy` | N | Retry policy |
+| Option        | Type               | Required | Description                                                         |
+| ------------- | ------------------ | -------- | ------------------------------------------------------------------- |
+| `version`     | `string`           | Y        | Workflow version (distinguishes from existing runs when changed)    |
+| `name`        | `string`           | N        | Workflow name (default: function name converted to underscore case) |
+| `schema`      | `StandardSchemaV1` | N        | Input validation schema (Zod, etc.)                                 |
+| `schedules`   | `Schedule[]`       | N        | Array of cron schedules                                             |
+| `retryPolicy` | `RetryPolicy`      | N        | Retry policy                                                        |
 
 ### Workflow Function Parameters
 
-| Parameter | Type | Description |
-|---------|------|------|
-| `input` | `Input` | Input value passed when the workflow runs |
-| `step` | `StepWrapper` | Tool for defining/executing steps |
-| `logger` | `Logger` | @logtape/logtape logger |
-| `version` | `string \| null` | Current workflow version |
+| Parameter | Type             | Description                               |
+| --------- | ---------------- | ----------------------------------------- |
+| `input`   | `Input`          | Input value passed when the workflow runs |
+| `step`    | `StepWrapper`    | Tool for defining/executing steps         |
+| `logger`  | `Logger`         | @logtape/logtape logger                   |
+| `version` | `string \| null` | Current workflow version                  |
 
 ## Step
 
@@ -61,10 +65,12 @@ An atomic unit of execution within a workflow. On failure, retry begins from tha
 ### step.define — Inline Function
 
 ```typescript
-const result = await step.define({ name: "fetch-data" }, async () => {
-  const data = await fetchSomething();
-  return data;
-}).run();
+const result = await step
+  .define({ name: "fetch-data" }, async () => {
+    const data = await fetchSomething();
+    return data;
+  })
+  .run();
 ```
 
 ### step.get — Wrapping an Existing Method
@@ -78,6 +84,7 @@ const result = await step.get({ name: "custom_step" }, MyService, "execute").run
 ```
 
 Overloads for `step.get`:
+
 - `step.get(object, methodName)` — Step name is the methodName converted to underscore case
 - `step.get({ name }, object, methodName)` — Step name specified directly
 
@@ -95,23 +102,28 @@ The wait time is preserved even if the server restarts.
 ## Scheduling (cron)
 
 ```typescript
-export const dailyReport = workflow({
-  version: "1",
-  schedules: [{
-    expression: "0 9 * * *",    // every day at 9am
-    name: "daily-report",        // optional (default: workflowName[expression])
-    input: () => ({ date: new Date().toISOString() }),  // optional
-  }],
-}, async ({ input, step }) => {
-  // ...
-});
+export const dailyReport = workflow(
+  {
+    version: "1",
+    schedules: [
+      {
+        expression: "0 9 * * *", // every day at 9am
+        name: "daily-report", // optional (default: workflowName[expression])
+        input: () => ({ date: new Date().toISOString() }), // optional
+      },
+    ],
+  },
+  async ({ input, step }) => {
+    // ...
+  },
+);
 ```
 
-| Field | Type | Required | Description |
-|------|------|------|------|
-| `expression` | `string` | Y | cron expression |
-| `name` | `string` | N | Schedule name (default: `workflowName[expression]`) |
-| `input` | `Executable<Input>` | N | Input value to pass on execution (function or value) |
+| Field        | Type                | Required | Description                                          |
+| ------------ | ------------------- | -------- | ---------------------------------------------------- |
+| `expression` | `string`            | Y        | cron expression                                      |
+| `name`       | `string`            | N        | Schedule name (default: `workflowName[expression]`)  |
+| `input`      | `Executable<Input>` | N        | Input value to pass on execution (function or value) |
 
 The timezone follows the `api.timezone` setting in `sonamu.config.ts`.
 
@@ -120,17 +132,20 @@ The timezone follows the `api.timezone` setting in `sonamu.config.ts`.
 ### Static Policy (Default)
 
 ```typescript
-export const reliableTask = workflow({
-  version: "1",
-  retryPolicy: {
-    maxAttempts: 5,           // maximum retry attempts (default: 5)
-    initialIntervalMs: 1000,  // first retry wait time (default: 1000ms)
-    backoffCoefficient: 2,    // wait time multiplier (default: 2)
-    maximumIntervalMs: 60000, // maximum wait time
+export const reliableTask = workflow(
+  {
+    version: "1",
+    retryPolicy: {
+      maxAttempts: 5, // maximum retry attempts (default: 5)
+      initialIntervalMs: 1000, // first retry wait time (default: 1000ms)
+      backoffCoefficient: 2, // wait time multiplier (default: 2)
+      maximumIntervalMs: 60000, // maximum wait time
+    },
   },
-}, async ({ step }) => {
-  // ...
-});
+  async ({ step }) => {
+    // ...
+  },
+);
 ```
 
 ### Dynamic Policy
@@ -152,9 +167,9 @@ export default defineConfig({
   tasks: {
     enableWorker: true,
     workerOptions: {
-      concurrency: 4,       // concurrent execution count (default: CPU cores - 1)
-      usePubSub: true,      // use DB pub/sub (default: true)
-      listenDelay: 500,      // execution delay after pub/sub receive in ms (default: 500)
+      concurrency: 4, // concurrent execution count (default: CPU cores - 1)
+      usePubSub: true, // use DB pub/sub (default: true)
+      listenDelay: 500, // execution delay after pub/sub receive in ms (default: 500)
     },
     contextProvider: (defaultContext) => {
       // build Context to use within workflows
@@ -164,13 +179,13 @@ export default defineConfig({
 });
 ```
 
-| Option | Type | Description |
-|------|------|------|
-| `enableWorker` | `boolean` | Whether to enable Worker (use only in daemon mode) |
-| `workerOptions.concurrency` | `number` | Number of concurrently executing tasks |
-| `workerOptions.usePubSub` | `boolean` | Use PostgreSQL pub/sub |
-| `workerOptions.listenDelay` | `number` | Execution delay after pub/sub receive (ms) |
-| `contextProvider` | `(ctx) => Context` | Context creation function when workflow runs |
+| Option                      | Type               | Description                                        |
+| --------------------------- | ------------------ | -------------------------------------------------- |
+| `enableWorker`              | `boolean`          | Whether to enable Worker (use only in daemon mode) |
+| `workerOptions.concurrency` | `number`           | Number of concurrently executing tasks             |
+| `workerOptions.usePubSub`   | `boolean`          | Use PostgreSQL pub/sub                             |
+| `workerOptions.listenDelay` | `number`           | Execution delay after pub/sub receive (ms)         |
+| `contextProvider`           | `(ctx) => Context` | Context creation function when workflow runs       |
 
 ## Manual Execution
 
@@ -180,7 +195,7 @@ import { Sonamu } from "sonamu";
 // Run via WorkflowManager
 const handle = await Sonamu.workflowManager.run(
   { name: "my-task", version: "1" },
-  { target: "manual" }
+  { target: "manual" },
 );
 
 // Wait for result