From 996eb4602ff42d2caa62bfef02ed3d8c54aa12db Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Mon, 30 Mar 2026 15:31:54 +0200
Subject: [PATCH 01/30] feat: Add Candy-style companion features

Character Schema:
- Add visibility, nsfwEnabled, nsfwLevel, relationshipMode
- Add personaProfile with personality, scenario, speakingStyle
- Add starterMessages and boundaries fields
- Migration 0008_lazy_wallflower.sql

Frontend Updates:
- CharacterDialog: New persona tab with NSFW/relationship controls
- CharacterItem: Show relationship/NSFW badges
- v2/index.vue: Better explore page with filters
- v2/[id].vue: New character detail page with profile view

Types & Stores:
- Updated CharacterBaseSchema with all new fields
- CharacterPersonaProfile interface added
- Local-first character store compatibility

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 apps/server/drizzle/0008_lazy_wallflower.sql  |  14 ++
 apps/server/drizzle/meta/_journal.json        |   9 +-
 .../src/routes/characters/route.test.ts       |  38 ++-
 apps/server/src/routes/characters/schema.ts   |  46 +++-
 apps/server/src/schemas/characters.ts         |  22 +-
 .../src/services/tests/characters.test.ts     |  33 ++-
 .../characters/components/CharacterDialog.vue | 126 ++++++++++
 .../characters/components/CharacterItem.vue   |  22 +-
 packages/stage-pages/src/pages/v2/[id].vue    | 222 ++++++++++++++++++
 packages/stage-pages/src/pages/v2/index.vue   | 104 ++++++--
 packages/stage-ui/src/stores/characters.ts    |  15 ++
 packages/stage-ui/src/types/character.ts      |  65 ++++-
 12 files changed, 684 insertions(+), 32 deletions(-)
 create mode 100644 apps/server/drizzle/0008_lazy_wallflower.sql
 create mode 100644 packages/stage-pages/src/pages/v2/[id].vue

diff --git a/apps/server/drizzle/0008_lazy_wallflower.sql b/apps/server/drizzle/0008_lazy_wallflower.sql
new file mode 100644
index 0000000000..2f45b7ffce
--- /dev/null
+++ b/apps/server/drizzle/0008_lazy_wallflower.sql
@@ -0,0 +1,14 @@
+ALTER TABLE "characters"
+ADD COLUMN "visibility" text DEFAULT 'private' NOT NULL;
+--> statement-breakpoint
+ALTER TABLE "characters"
+ADD COLUMN "nsfw_enabled" boolean DEFAULT false NOT NULL;
+--> statement-breakpoint
+ALTER TABLE "characters"
+ADD COLUMN "nsfw_level" text DEFAULT 'none' NOT NULL;
+--> statement-breakpoint
+ALTER TABLE "characters"
+ADD COLUMN "relationship_mode" text DEFAULT 'companion' NOT NULL;
+--> statement-breakpoint
+ALTER TABLE "characters"
+ADD COLUMN "persona_profile" jsonb DEFAULT '{}'::jsonb NOT NULL;
diff --git a/apps/server/drizzle/meta/_journal.json b/apps/server/drizzle/meta/_journal.json
index 12cea9e473..2732d7165c 100644
--- a/apps/server/drizzle/meta/_journal.json
+++ b/apps/server/drizzle/meta/_journal.json
@@ -57,6 +57,13 @@
       "when": 1774632446757,
       "tag": "0007_red_nicolaos",
       "breakpoints": true
+    },
+    {
+      "idx": 8,
+      "version": "7",
+      "when": 1774800000000,
+      "tag": "0008_lazy_wallflower",
+      "breakpoints": true
     }
   ]
-}
\ No newline at end of file
+}
diff --git a/apps/server/src/routes/characters/route.test.ts b/apps/server/src/routes/characters/route.test.ts
index 6a6da29b96..15584919c5 100644
--- a/apps/server/src/routes/characters/route.test.ts
+++ b/apps/server/src/routes/characters/route.test.ts
@@ -67,7 +67,22 @@ describe('characterRoutes', () => {
 
   it('post / should create character with cover', async () => {
     const payload = {
-      character: { version: '1', coverUrl: 'url', characterId: 'cid' },
+      character: {
+        version: '1',
+        coverUrl: 'url',
+        characterId: 'cid',
+        visibility: 'public',
+        nsfwEnabled: true,
+        nsfwLevel: 'suggestive',
+        relationshipMode: 'romance',
+        personaProfile: {
+          personality: 'Playful',
+          scenario: 'Late-night texting',
+          speakingStyle: 'Teasing',
+          starterMessages: ['You took long enough.'],
+          memoryProfile: 'deep',
+        },
+      },
       i18n: [{ language: 'en', name: 'Aster', description: 'desc', tags: [] }],
       cover: { foregroundUrl: 'fg', backgroundUrl: 'bg' },
     }
@@ -84,6 +99,12 @@ describe('characterRoutes', () => {
 
     const char = await characterService.findById(data.id)
     expect(char?.cover?.foregroundUrl).toBe('fg')
+    expect(char?.visibility).toBe('public')
+    expect(char?.nsfwEnabled).toBe(true)
+    expect(char?.personaProfile).toMatchObject({
+      personality: 'Playful',
+      memoryProfile: 'deep',
+    })
   })
 
   it('get / should return created character', async () => {
@@ -118,13 +139,26 @@ describe('characterRoutes', () => {
 
     const res = await app.fetch(new Request(`http://localhost/${charId}`, {
       method: 'PATCH',
-      body: JSON.stringify({ version: '2.0' }),
+      body: JSON.stringify({
+        version: '2.0',
+        nsfwLevel: 'explicit',
+        relationshipMode: 'roleplay',
+        personaProfile: {
+          personality: 'Direct',
+          boundaries: ['no minors'],
+        },
+      }),
       headers: { 'Content-Type': 'application/json' },
     }), { user: testUser } as any)
 
     expect(res.status).toBe(200)
     const char = await characterService.findById(charId)
     expect(char?.version).toBe('2.0')
+    expect(char?.nsfwLevel).toBe('explicit')
+    expect(char?.relationshipMode).toBe('roleplay')
+    expect(char?.personaProfile).toMatchObject({
+      personality: 'Direct',
+    })
   })
 
   it('patch /:id should return 403 if not owner', async () => {
diff --git a/apps/server/src/routes/characters/schema.ts b/apps/server/src/routes/characters/schema.ts
index 071375f854..913cdd73e0 100644
--- a/apps/server/src/routes/characters/schema.ts
+++ b/apps/server/src/routes/characters/schema.ts
@@ -1,5 +1,5 @@
 import { createInsertSchema, createSelectSchema } from 'drizzle-valibot'
-import { array, literal, number, object, optional, pipe, string, transform, union } from 'valibot'
+import { array, boolean, literal, number, object, optional, pipe, string, transform, union } from 'valibot'
 
 import * as schema from '../../schemas/characters'
 
@@ -45,6 +45,40 @@ const AvatarModelTypeSchema = union([
   literal('live2d'),
 ])
 
+const CharacterVisibilitySchema = union([
+  literal('private'),
+  literal('public'),
+  literal('unlisted'),
+])
+
+const CharacterNsfwLevelSchema = union([
+  literal('none'),
+  literal('suggestive'),
+  literal('explicit'),
+])
+
+const CharacterRelationshipModeSchema = union([
+  literal('companion'),
+  literal('romance'),
+  literal('roleplay'),
+])
+
+const CharacterMemoryProfileSchema = union([
+  literal('light'),
+  literal('standard'),
+  literal('deep'),
+])
+
+export const CharacterPersonaProfileSchema = object({
+  personality: optional(string()),
+  scenario: optional(string()),
+  speakingStyle: optional(string()),
+  traits: optional(array(string())),
+  boundaries: optional(array(string())),
+  starterMessages: optional(array(string())),
+  memoryProfile: optional(CharacterMemoryProfileSchema),
+})
+
 export const CharacterSchema = createSelectSchema(schema.character)
 export const InsertCharacterSchema = createInsertSchema(schema.character)
 
@@ -77,6 +111,11 @@ export const CreateCharacterSchema = object({
     avatarUrl: optional(string()),
     creatorRole: optional(string()),
     priceCredit: optional(string()),
+    visibility: optional(CharacterVisibilitySchema),
+    nsfwEnabled: optional(boolean()),
+    nsfwLevel: optional(CharacterNsfwLevelSchema),
+    relationshipMode: optional(CharacterRelationshipModeSchema),
+    personaProfile: optional(CharacterPersonaProfileSchema),
   }),
   cover: optional(createInsertSchema(schema.characterCovers, {
     characterId: optional(string()),
@@ -109,6 +148,11 @@ export const UpdateCharacterSchema = createInsertSchema(schema.character, {
   avatarUrl: optional(string()),
   creatorRole: optional(string()),
   priceCredit: optional(string()),
+  visibility: optional(CharacterVisibilitySchema),
+  nsfwEnabled: optional(boolean()),
+  nsfwLevel: optional(CharacterNsfwLevelSchema),
+  relationshipMode: optional(CharacterRelationshipModeSchema),
+  personaProfile: optional(CharacterPersonaProfileSchema),
   creatorId: optional(string()),
   ownerId: optional(string()),
   characterId: optional(string()),
diff --git a/apps/server/src/schemas/characters.ts b/apps/server/src/schemas/characters.ts
index a7482ea3a7..42af343274 100644
--- a/apps/server/src/schemas/characters.ts
+++ b/apps/server/src/schemas/characters.ts
@@ -4,7 +4,7 @@ import type { AvatarModelConfig } from '../types/character-avatar-model'
 import type { CharacterCapabilityConfig } from '../types/character-capability'
 
 import { relations } from 'drizzle-orm'
-import { integer, jsonb, pgTable, text, timestamp } from 'drizzle-orm/pg-core'
+import { boolean, integer, jsonb, pgTable, text, timestamp } from 'drizzle-orm/pg-core'
 
 import { nanoid } from '../utils/id'
 import { user } from './accounts'
@@ -25,6 +25,11 @@ export const character = pgTable(
     avatarUrl: text('avatar_url'),
     creatorRole: text('creator_role'),
     priceCredit: text('price_credit').default('0').notNull(),
+    visibility: text('visibility').$type<CharacterVisibility>().default('private').notNull(),
+    nsfwEnabled: boolean('nsfw_enabled').default(false).notNull(),
+    nsfwLevel: text('nsfw_level').$type<CharacterNsfwLevel>().default('none').notNull(),
+    relationshipMode: text('relationship_mode').$type<CharacterRelationshipMode>().default('companion').notNull(),
+    personaProfile: jsonb('persona_profile').$type<CharacterPersonaProfile>().default({}).notNull(),
 
     likesCount: integer('likes_count').default(0).notNull(),
     bookmarksCount: integer('bookmarks_count').default(0).notNull(),
@@ -40,6 +45,21 @@ export const character = pgTable(
 export type Character = InferSelectModel<typeof character>
 export type NewCharacter = InferInsertModel<typeof character>
 
+export type CharacterVisibility = 'private' | 'public' | 'unlisted'
+export type CharacterNsfwLevel = 'none' | 'suggestive' | 'explicit'
+export type CharacterRelationshipMode = 'companion' | 'romance' | 'roleplay'
+export type CharacterMemoryProfile = 'light' | 'standard' | 'deep'
+
+export interface CharacterPersonaProfile {
+  personality?: string
+  scenario?: string
+  speakingStyle?: string
+  traits?: string[]
+  boundaries?: string[]
+  starterMessages?: string[]
+  memoryProfile?: CharacterMemoryProfile
+}
+
 export const characterCovers = pgTable(
   'character_covers',
   {
diff --git a/apps/server/src/services/tests/characters.test.ts b/apps/server/src/services/tests/characters.test.ts
index 67c6186467..69b530013b 100644
--- a/apps/server/src/services/tests/characters.test.ts
+++ b/apps/server/src/services/tests/characters.test.ts
@@ -33,6 +33,18 @@ describe('characterService', () => {
       characterId: 'cid',
       ownerId: testUser.id,
       creatorId: testUser.id,
+      visibility: 'public' as const,
+      nsfwEnabled: true,
+      nsfwLevel: 'suggestive' as const,
+      relationshipMode: 'romance' as const,
+      personaProfile: {
+        personality: 'Playful and teasing',
+        speakingStyle: 'Flirty',
+        traits: ['witty', 'warm'],
+        boundaries: ['no violence'],
+        starterMessages: ['Missed me?'],
+        memoryProfile: 'deep' as const,
+      },
     }
 
     const result = await service.create({
@@ -46,6 +58,13 @@ describe('characterService', () => {
     const found = await service.findById('char-1')
     expect(found?.i18n[0].name).toBe('Aster')
     expect(found?.cover?.foregroundUrl).toBe('fg')
+    expect(found?.visibility).toBe('public')
+    expect(found?.nsfwEnabled).toBe(true)
+    expect(found?.relationshipMode).toBe('romance')
+    expect(found?.personaProfile).toMatchObject({
+      personality: 'Playful and teasing',
+      memoryProfile: 'deep',
+    })
   })
 
   it('findAll should return characters with relations', async () => {
@@ -93,9 +112,21 @@ describe('characterService', () => {
   })
 
   it('update should update character fields', async () => {
-    await service.update('char-1', { version: '2.0' })
+    await service.update('char-1', {
+      version: '2.0',
+      nsfwLevel: 'explicit',
+      personaProfile: {
+        personality: 'More intense',
+        memoryProfile: 'standard',
+      },
+    })
     const char = await service.findById('char-1')
     expect(char?.version).toBe('2.0')
+    expect(char?.nsfwLevel).toBe('explicit')
+    expect(char?.personaProfile).toMatchObject({
+      personality: 'More intense',
+      memoryProfile: 'standard',
+    })
   })
 
   it('delete should soft delete character', async () => {
diff --git a/apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue b/apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue
index 5912fa75e1..1c8ed84303 100644
--- a/apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue
+++ b/apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue
@@ -32,8 +32,17 @@ const form = reactive({
   characterId: '',
   version: '1.0.0',
   coverUrl: '',
+  visibility: 'private' as 'private' | 'public' | 'unlisted',
+  nsfwEnabled: false,
+  nsfwLevel: 'none' as 'none' | 'suggestive' | 'explicit',
+  relationshipMode: 'companion' as 'companion' | 'romance' | 'roleplay',
   name: '',
   description: '',
+  personality: '',
+  scenario: '',
+  speakingStyle: '',
+  starterMessages: '',
+  boundaries: '',
 
   // Capability: LLM
   llmModel: '',
@@ -54,8 +63,17 @@ watch(() => props.character, (char) => {
     form.characterId = char.characterId
     form.version = char.version
     form.coverUrl = char.coverUrl
+    form.visibility = char.visibility
+    form.nsfwEnabled = char.nsfwEnabled
+    form.nsfwLevel = char.nsfwLevel
+    form.relationshipMode = char.relationshipMode
     form.name = i18n?.name || ''
     form.description = i18n?.description || ''
+    form.personality = char.personaProfile?.personality || ''
+    form.scenario = char.personaProfile?.scenario || ''
+    form.speakingStyle = char.personaProfile?.speakingStyle || ''
+    form.starterMessages = char.personaProfile?.starterMessages?.join('\n') || ''
+    form.boundaries = char.personaProfile?.boundaries?.join('\n') || ''
 
     form.llmModel = llm?.config.llm?.model || ''
     form.llmTemperature = llm?.config.llm?.temperature || 0.7
@@ -68,8 +86,17 @@ watch(() => props.character, (char) => {
     form.characterId = ''
     form.version = '1.0.0'
     form.coverUrl = ''
+    form.visibility = 'private'
+    form.nsfwEnabled = false
+    form.nsfwLevel = 'none'
+    form.relationshipMode = 'companion'
     form.name = ''
     form.description = ''
+    form.personality = ''
+    form.scenario = ''
+    form.speakingStyle = ''
+    form.starterMessages = ''
+    form.boundaries = ''
     form.llmModel = 'gpt-4o-mini'
     form.llmTemperature = 0.7
     form.ttsVoiceId = ''
@@ -90,6 +117,24 @@ async function handleSubmit() {
       characterId: form.characterId,
       version: form.version,
       coverUrl: form.coverUrl,
+      visibility: form.visibility,
+      nsfwEnabled: form.nsfwEnabled,
+      nsfwLevel: form.nsfwLevel,
+      relationshipMode: form.relationshipMode,
+      personaProfile: {
+        personality: form.personality || undefined,
+        scenario: form.scenario || undefined,
+        speakingStyle: form.speakingStyle || undefined,
+        starterMessages: form.starterMessages
+          .split('\n')
+          .map(item => item.trim())
+          .filter(Boolean),
+        boundaries: form.boundaries
+          .split('\n')
+          .map(item => item.trim())
+          .filter(Boolean),
+        memoryProfile: form.relationshipMode === 'romance' ? 'deep' : 'standard',
+      },
     },
     i18n: [{
       language: 'en',
@@ -151,6 +196,24 @@ async function handleSubmit() {
         characterId: form.characterId,
         version: form.version,
         coverUrl: form.coverUrl,
+        visibility: form.visibility,
+        nsfwEnabled: form.nsfwEnabled,
+        nsfwLevel: form.nsfwLevel,
+        relationshipMode: form.relationshipMode,
+        personaProfile: {
+          personality: form.personality || undefined,
+          scenario: form.scenario || undefined,
+          speakingStyle: form.speakingStyle || undefined,
+          starterMessages: form.starterMessages
+            .split('\n')
+            .map(item => item.trim())
+            .filter(Boolean),
+          boundaries: form.boundaries
+            .split('\n')
+            .map(item => item.trim())
+            .filter(Boolean),
+          memoryProfile: form.relationshipMode === 'romance' ? 'deep' : 'standard',
+        },
       })
       // Capabilities/I18n update not supported in simple UpdateCharacterSchema yet?
       // Checking types/character.ts: UpdateCharacterSchema only has version, coverUrl, characterId.
@@ -179,6 +242,7 @@ async function handleSubmit() {
 const activeTab = ref('identity')
 const tabs = [
   { id: 'identity', label: 'Identity', icon: 'i-solar:user-id-bold-duotone' },
+  { id: 'persona', label: 'Persona', icon: 'i-solar:mask-happly-bold-duotone' },
   { id: 'capabilities', label: 'Capabilities', icon: 'i-solar:cpu-bolt-bold-duotone' },
   // { id: 'models', label: 'Models', icon: 'i-solar:box-minimalistic-bold-duotone' },
 ]
@@ -233,6 +297,68 @@ const isOpen = computed({
                 <FieldInput v-model="form.name" label="Name (EN)" placeholder="Character Name" required />
                 <FieldInput v-model="form.description" label="Description" type="textarea" placeholder="Short description..." />
                 <FieldInput v-model="form.coverUrl" label="Cover URL" placeholder="https://..." />
+
+                <div class="grid grid-cols-2 gap-4">
+                  <div class="flex flex-col gap-1.5">
+                    <label class="text-sm text-neutral-700 font-medium dark:text-neutral-300">Visibility</label>
+                    <select v-model="form.visibility" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 focus:border-primary-500 dark:bg-neutral-800 focus:ring-2 focus:ring-primary-500/20">
+                      <option value="private">
+                        Private
+                      </option>
+                      <option value="unlisted">
+                        Unlisted
+                      </option>
+                      <option value="public">
+                        Public
+                      </option>
+                    </select>
+                  </div>
+
+                  <div class="flex flex-col gap-1.5">
+                    <label class="text-sm text-neutral-700 font-medium dark:text-neutral-300">Relationship Mode</label>
+                    <select v-model="form.relationshipMode" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 focus:border-primary-500 dark:bg-neutral-800 focus:ring-2 focus:ring-primary-500/20">
+                      <option value="companion">
+                        Companion
+                      </option>
+                      <option value="romance">
+                        Romance
+                      </option>
+                      <option value="roleplay">
+                        Roleplay
+                      </option>
+                    </select>
+                  </div>
+                </div>
+
+                <div class="grid grid-cols-[auto,1fr] items-center gap-4 rounded-xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800/60">
+                  <label class="text-sm text-neutral-700 font-medium dark:text-neutral-300">Enable NSFW</label>
+                  <div class="flex items-center justify-end">
+                    <input v-model="form.nsfwEnabled" type="checkbox" class="h-4 w-4 rounded border-neutral-300 text-primary-600 focus:ring-primary-500">
+                  </div>
+                </div>
+
+                <div class="flex flex-col gap-1.5">
+                  <label class="text-sm text-neutral-700 font-medium dark:text-neutral-300">NSFW Level</label>
+                  <select v-model="form.nsfwLevel" :disabled="!form.nsfwEnabled" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none disabled:cursor-not-allowed disabled:opacity-50 dark:border-neutral-700 focus:border-primary-500 dark:bg-neutral-800 focus:ring-2 focus:ring-primary-500/20">
+                    <option value="none">
+                      None
+                    </option>
+                    <option value="suggestive">
+                      Suggestive
+                    </option>
+                    <option value="explicit">
+                      Explicit
+                    </option>
+                  </select>
+                </div>
+              </div>
+
+              <div v-show="activeTab === 'persona'" class="space-y-4">
+                <FieldInput v-model="form.personality" label="Personality" type="textarea" placeholder="Playful, affectionate, teasing, confident..." />
+                <FieldInput v-model="form.scenario" label="Scenario" type="textarea" placeholder="What world or dynamic does this companion live in?" />
+                <FieldInput v-model="form.speakingStyle" label="Speaking Style" placeholder="Warm, direct, bratty, elegant..." />
+                <FieldInput v-model="form.starterMessages" label="Starter Messages" type="textarea" placeholder="One per line. These will seed the first interaction." />
+                <FieldInput v-model="form.boundaries" label="Boundaries" type="textarea" placeholder="One per line. Use this to set hard stops or no-go zones." />
               </div>
 
               <!-- Capabilities Tab -->
diff --git a/apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue b/apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue
index 15f1567cf1..b0cdb07f53 100644
--- a/apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue
+++ b/apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue
@@ -26,6 +26,14 @@ const i18n = computed(() => {
 
 const name = computed(() => i18n.value?.name || 'Unknown')
 const description = computed(() => i18n.value?.description || '')
+const personaSummary = computed(() => props.character.personaProfile?.personality || description.value)
+const badges = computed(() => {
+  const items = [props.character.relationshipMode]
+  if (props.character.nsfwEnabled)
+    items.push(props.character.nsfwLevel)
+  items.push(props.character.visibility)
+  return items
+})
 
 const consciousnessModel = computed(() => {
   if (!props.character.capabilities)
@@ -67,8 +75,18 @@ const voiceModel = computed(() => {
       </div>
 
       <!-- Card description -->
-      <p v-if="description" class="line-clamp-3 min-h-40px flex-1 text-sm text-neutral-500 dark:text-neutral-400">
-        {{ description }}
+      <div class="z-1 flex flex-wrap gap-1.5">
+        <span
+          v-for="badge in badges"
+          :key="badge"
+          class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] text-neutral-600 font-medium uppercase tracking-wide dark:bg-neutral-800 dark:text-neutral-300"
+        >
+          {{ badge }}
+        </span>
+      </div>
+
+      <p v-if="personaSummary" class="line-clamp-3 min-h-40px flex-1 text-sm text-neutral-500 dark:text-neutral-400">
+        {{ personaSummary }}
       </p>
 
       <!-- Card stats -->
diff --git a/packages/stage-pages/src/pages/v2/[id].vue b/packages/stage-pages/src/pages/v2/[id].vue
new file mode 100644
index 0000000000..da302bf24a
--- /dev/null
+++ b/packages/stage-pages/src/pages/v2/[id].vue
@@ -0,0 +1,222 @@
+<script setup lang="ts">
+import { useAuthStore } from '@proj-airi/stage-ui/stores/auth'
+import { useCharacterStore } from '@proj-airi/stage-ui/stores/characters'
+import { Button } from '@proj-airi/ui'
+import { computed, onMounted, ref } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+
+const route = useRoute()
+const router = useRouter()
+const characterStore = useCharacterStore()
+const authStore = useAuthStore()
+
+const loading = ref(true)
+const failed = ref(false)
+
+const characterId = computed(() => String(route.params.id || ''))
+
+onMounted(async () => {
+  loading.value = true
+  failed.value = false
+  try {
+    await characterStore.fetchById(characterId.value)
+  }
+  catch {
+    failed.value = true
+  }
+  finally {
+    loading.value = false
+  }
+})
+
+const character = computed(() => characterStore.getCharacter(characterId.value))
+const i18n = computed(() => character.value?.i18n?.[0])
+const badges = computed(() => {
+  if (!character.value)
+    return []
+
+  const items = [character.value.relationshipMode, character.value.visibility]
+  if (character.value.nsfwEnabled)
+    items.push(character.value.nsfwLevel)
+  return items
+})
+
+const starterMessages = computed(() => character.value?.personaProfile?.starterMessages || [])
+const boundaries = computed(() => character.value?.personaProfile?.boundaries || [])
+const liked = computed(() => !!character.value?.likes?.some(item => item.userId === authStore.user?.id))
+const bookmarked = computed(() => !!character.value?.bookmarks?.some(item => item.userId === authStore.user?.id))
+</script>
+
+<template>
+  <div class="min-h-screen px-4 py-8 md:px-8">
+    <div mx-auto max-w-6xl>
+      <div class="mb-6 flex items-center justify-between gap-4">
+        <Button variant="ghost" @click="router.push('/v2')">
+          Back to Explore
+        </Button>
+        <div v-if="character" class="flex items-center gap-2">
+          <Button variant="ghost" @click="characterStore.bookmark(character.id)">
+            {{ bookmarked ? 'Bookmarked' : 'Bookmark' }}
+          </Button>
+          <Button variant="ghost" @click="characterStore.like(character.id)">
+            {{ liked ? 'Liked' : 'Like' }}
+          </Button>
+        </div>
+      </div>
+
+      <div v-if="loading" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        Loading companion profile...
+      </div>
+
+      <div v-else-if="failed || !character || !i18n" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        Character not found.
+      </div>
+
+      <div v-else class="grid gap-6 lg:grid-cols-[1.15fr,0.85fr]">
+        <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-neutral-900 to-rose-950 text-white shadow-sm">
+          <img
+            :src="character.coverUrl"
+            :alt="i18n.name"
+            class="absolute inset-0 h-full w-full object-cover opacity-40"
+          >
+          <div class="absolute inset-0 bg-linear-to-t from-black via-black/45 to-transparent" />
+          <div class="relative z-1 flex min-h-[34rem] flex-col justify-end gap-5 p-6 md:p-8">
+            <div class="flex flex-wrap gap-2">
+              <span
+                v-for="badge in badges"
+                :key="badge"
+                class="rounded-full bg-white/12 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur"
+              >
+                {{ badge }}
+              </span>
+            </div>
+
+            <div class="max-w-2xl">
+              <h1 class="text-4xl font-semibold md:text-5xl">
+                {{ i18n.name }}
+              </h1>
+              <p class="mt-3 max-w-xl text-sm text-white/80 leading-6 md:text-base">
+                {{ character.personaProfile?.personality || i18n.description }}
+              </p>
+            </div>
+
+            <div class="grid gap-3 sm:grid-cols-3">
+              <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
+                <div class="text-[11px] text-white/60 uppercase tracking-[0.16em]">
+                  Dynamic
+                </div>
+                <div class="mt-1 text-sm font-medium">
+                  {{ character.relationshipMode }}
+                </div>
+              </div>
+              <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
+                <div class="text-[11px] text-white/60 uppercase tracking-[0.16em]">
+                  Personality
+                </div>
+                <div class="mt-1 text-sm font-medium">
+                  {{ character.personaProfile?.speakingStyle || 'Adaptive' }}
+                </div>
+              </div>
+              <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
+                <div class="text-[11px] text-white/60 uppercase tracking-[0.16em]">
+                  Access
+                </div>
+                <div class="mt-1 text-sm font-medium">
+                  {{ character.visibility }}
+                </div>
+              </div>
+            </div>
+
+            <div class="flex flex-wrap gap-3">
+              <Button @click="router.push('/')">
+                Enter Stage
+              </Button>
+              <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/settings/characters')">
+                Edit Character
+              </Button>
+            </div>
+          </div>
+        </section>
+
+        <section class="flex flex-col gap-6">
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Scenario
+            </h2>
+            <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+              {{ character.personaProfile?.scenario || i18n.description }}
+            </p>
+          </div>
+
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Starter Messages
+            </h2>
+            <div v-if="starterMessages.length" class="mt-3 flex flex-col gap-2">
+              <div
+                v-for="message in starterMessages"
+                :key="message"
+                class="rounded-2xl bg-neutral-50 px-4 py-3 text-sm text-neutral-700 dark:bg-neutral-800 dark:text-neutral-200"
+              >
+                {{ message }}
+              </div>
+            </div>
+            <p v-else class="mt-3 text-sm text-neutral-500 dark:text-neutral-400">
+              No custom starters yet.
+            </p>
+          </div>
+
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Boundaries
+            </h2>
+            <div v-if="boundaries.length" class="mt-3 flex flex-wrap gap-2">
+              <span
+                v-for="boundary in boundaries"
+                :key="boundary"
+                class="rounded-full bg-amber-100 px-3 py-1 text-xs text-amber-700 font-medium dark:bg-amber-500/15 dark:text-amber-300"
+              >
+                {{ boundary }}
+              </span>
+            </div>
+            <p v-else class="mt-3 text-sm text-neutral-500 dark:text-neutral-400">
+              No explicit boundaries configured.
+            </p>
+          </div>
+
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Engagement
+            </h2>
+            <div class="mt-4 grid grid-cols-3 gap-3">
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 text-center dark:bg-neutral-800">
+                <div class="text-xl font-semibold">
+                  {{ character.likesCount }}
+                </div>
+                <div class="text-xs text-neutral-500 uppercase tracking-wide dark:text-neutral-400">
+                  Likes
+                </div>
+              </div>
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 text-center dark:bg-neutral-800">
+                <div class="text-xl font-semibold">
+                  {{ character.bookmarksCount }}
+                </div>
+                <div class="text-xs text-neutral-500 uppercase tracking-wide dark:text-neutral-400">
+                  Saves
+                </div>
+              </div>
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 text-center dark:bg-neutral-800">
+                <div class="text-xl font-semibold">
+                  {{ character.interactionsCount }}
+                </div>
+                <div class="text-xs text-neutral-500 uppercase tracking-wide dark:text-neutral-400">
+                  Chats
+                </div>
+              </div>
+            </div>
+          </div>
+        </section>
+      </div>
+    </div>
+  </div>
+</template>
diff --git a/packages/stage-pages/src/pages/v2/index.vue b/packages/stage-pages/src/pages/v2/index.vue
index cfa3c474e4..9e9fe75eb7 100644
--- a/packages/stage-pages/src/pages/v2/index.vue
+++ b/packages/stage-pages/src/pages/v2/index.vue
@@ -2,10 +2,13 @@
 import { useAuthStore } from '@proj-airi/stage-ui/stores/auth'
 import { useCharacterStore } from '@proj-airi/stage-ui/stores/characters'
 import { Button } from '@proj-airi/ui'
-import { computed, onMounted } from 'vue'
+import { computed, onMounted, ref } from 'vue'
+import { useRouter } from 'vue-router'
 
 const characterStore = useCharacterStore()
 const authStore = useAuthStore()
+const router = useRouter()
+const activeFilter = ref<'all' | 'companion' | 'romance' | 'roleplay' | 'nsfw'>('all')
 
 const coverImage = new URL('../../../../stage-ui/src/components/menu/relu.avif', import.meta.url).href
 const characterAvatarImage = new URL('../../../../stage-ui/src/assets/live2d/models/hiyori/preview.png', import.meta.url).href
@@ -38,7 +41,15 @@ onMounted(() => {
   characterStore.fetchList(true)
 })
 
-const characters = computed(() => Array.from(characterStore.characters.values()).map((char) => {
+const characters = computed(() => Array.from(characterStore.characters.values())
+  .filter((char) => {
+    if (activeFilter.value === 'all')
+      return true
+    if (activeFilter.value === 'nsfw')
+      return char.nsfwEnabled
+    return char.relationshipMode === activeFilter.value
+  })
+  .map((char) => {
   const i18n = char.i18n?.[0] || { name: 'Unknown', tagline: '', description: '' }
 
   return {
@@ -54,17 +65,61 @@ const characters = computed(() => Array.from(characterStore.characters.values())
     likes: char.likesCount,
     bookmarks: char.bookmarksCount,
     forks: char.forksCount,
+    visibility: char.visibility,
+    nsfwEnabled: char.nsfwEnabled,
+    nsfwLevel: char.nsfwLevel,
+    relationshipMode: char.relationshipMode,
+    personality: char.personaProfile?.personality,
+    scenario: char.personaProfile?.scenario,
     liked: char.likes?.some(l => l.userId === authStore.user?.id),
     bookmarked: char.bookmarks?.some(b => b.userId === authStore.user?.id),
     priceCredit: char.priceCredit,
   }
 }))
+
+const filters = [
+  { id: 'all', label: 'All' },
+  { id: 'companion', label: 'Companion' },
+  { id: 'romance', label: 'Romance' },
+  { id: 'roleplay', label: 'Roleplay' },
+  { id: 'nsfw', label: 'NSFW' },
+] as const
 </script>
 
 <template>
-  <div :class="['min-h-screen w-full']">
-    <div>
-      <div :class="['mt-10 grid gap-6', 'sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5']">
+  <div :class="['min-h-screen w-full px-4 py-8 md:px-8']">
+    <div mx-auto max-w-7xl>
+      <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-rose-50 via-white to-amber-50 px-6 py-8 shadow-sm ring-1 ring-neutral-200/70 md:px-10 md:py-12 dark:from-neutral-950 dark:via-neutral-900 dark:to-neutral-950 dark:ring-neutral-800">
+        <div class="absolute right--10 top--10 h-56 w-56 rounded-full bg-rose-300/20 blur-3xl dark:bg-rose-500/10" />
+        <div class="absolute bottom--14 left-10 h-48 w-48 rounded-full bg-amber-300/20 blur-3xl dark:bg-amber-500/10" />
+        <div relative z-1 max-w-3xl>
+          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/80 px-3 py-1 text-xs text-neutral-600 font-medium backdrop-blur dark:bg-neutral-800/80 dark:text-neutral-300">
+            <div class="i-solar:hearts-line-duotone text-sm text-rose-500" />
+            Explore companions, romance, and roleplay personas
+          </div>
+          <h1 class="max-w-2xl text-4xl text-neutral-950 font-semibold leading-tight md:text-5xl dark:text-white">
+            Find a companion that actually feels intentional
+          </h1>
+          <p class="mt-4 max-w-2xl text-sm text-neutral-600 leading-6 md:text-base dark:text-neutral-300">
+            Browse character profiles, compare dynamics, and jump into companions built for companionship, romance, or fantasy roleplay instead of generic chatbot cards.
+          </p>
+          <div class="mt-6 flex flex-wrap gap-2">
+            <button
+              v-for="filter in filters"
+              :key="filter.id"
+              class="rounded-full px-4 py-2 text-sm font-medium transition-all"
+              :class="activeFilter === filter.id
+                ? 'bg-neutral-950 text-white dark:bg-white dark:text-neutral-950'
+                : 'bg-white text-neutral-700 ring-1 ring-neutral-200 hover:bg-neutral-100 dark:bg-neutral-900 dark:text-neutral-200 dark:ring-neutral-700 dark:hover:bg-neutral-800'"
+              @click="activeFilter = filter.id"
+            >
+              {{ filter.label }}
+            </button>
+          </div>
+        </div>
+      </section>
+
+      <div class="mt-8 grid gap-6 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5">
         <article
           v-for="character in characters"
           :key="character.id"
@@ -165,8 +220,22 @@ const characters = computed(() => Array.from(characterStore.characters.values())
                     </div>
                   </button>
                 </div>
+                <div class="flex flex-wrap gap-1.5">
+                  <span class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] text-neutral-600 font-medium uppercase tracking-wide dark:bg-neutral-800 dark:text-neutral-300">
+                    {{ character.relationshipMode }}
+                  </span>
+                  <span
+                    v-if="character.nsfwEnabled"
+                    class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] text-rose-700 font-medium uppercase tracking-wide dark:bg-rose-500/15 dark:text-rose-300"
+                  >
+                    {{ character.nsfwLevel }}
+                  </span>
+                  <span class="rounded-full bg-amber-100 px-2 py-0.5 text-[10px] text-amber-700 font-medium uppercase tracking-wide dark:bg-amber-500/15 dark:text-amber-300">
+                    {{ character.visibility }}
+                  </span>
+                </div>
                 <div :class="['flex-1 text-xs text-ellipsis text-neutral-500 line-clamp-3 max-h-[3rem] overflow-hidden']">
-                  {{ character.tagline }}
+                  {{ character.personality || character.scenario || character.tagline }}
                 </div>
                 <div :class="['grid grid-cols-3 items-center']">
                   <div :class="['flex items-center justify-start']">
@@ -208,29 +277,18 @@ const characters = computed(() => Array.from(characterStore.characters.values())
                     </Button>
                   </div>
                   <div :class="['flex items-center justify-end']">
-                    <div
+                    <button
+                      type="button"
                       :class="[
                         'flex flex-row items-center gap-1',
                         'pl-1.5 pr-2 py-1 rounded-full',
                         'bg-neutral-900/50',
                       ]"
+                      @click="router.push(`/v2/${character.id}`)"
                     >
-                      <div
-                        :class="[
-                          'i-ph:plus-bold',
-                          'text-xs inline-block',
-                          'text-neutral-100 dark:text-neutral-900',
-                        ]"
-                      />
-                      <span
-                        :class="[
-                          'text-xs',
-                          'text-neutral-100 dark:text-neutral-900',
-                        ]"
-                      >
-                        Chat
-                      </span>
-                    </div>
+                      <div :class="['i-solar:chat-square-bold text-xs inline-block text-neutral-100 dark:text-neutral-900']" />
+                      <span :class="['text-xs', 'text-neutral-100 dark:text-neutral-900']">Open</span>
+                    </button>
                   </div>
                 </div>
               </div>
diff --git a/packages/stage-ui/src/stores/characters.ts b/packages/stage-ui/src/stores/characters.ts
index 1d66e48e19..7696baad1a 100644
--- a/packages/stage-ui/src/stores/characters.ts
+++ b/packages/stage-ui/src/stores/characters.ts
@@ -24,10 +24,15 @@ function buildLocalCharacter(userId: string, payload: CreateCharacterPayload) {
     coverBackgroundUrl: undefined,
     creatorRole: undefined,
     priceCredit: '0',
+    visibility: payload.character.visibility ?? 'private',
+    nsfwEnabled: payload.character.nsfwEnabled ?? false,
+    nsfwLevel: payload.character.nsfwLevel ?? 'none',
+    relationshipMode: payload.character.relationshipMode ?? 'companion',
     likesCount: 0,
     bookmarksCount: 0,
     interactionsCount: 0,
     forksCount: 0,
+    personaProfile: payload.character.personaProfile ?? {},
     creatorId: userId,
     ownerId: userId,
     characterId: payload.character.characterId,
@@ -176,6 +181,16 @@ export const useCharacterStore = defineStore('characters', () => {
           character.coverUrl = payload.coverUrl
         if (payload.characterId !== undefined)
           character.characterId = payload.characterId
+        if (payload.visibility !== undefined)
+          character.visibility = payload.visibility
+        if (payload.nsfwEnabled !== undefined)
+          character.nsfwEnabled = payload.nsfwEnabled
+        if (payload.nsfwLevel !== undefined)
+          character.nsfwLevel = payload.nsfwLevel
+        if (payload.relationshipMode !== undefined)
+          character.relationshipMode = payload.relationshipMode
+        if (payload.personaProfile !== undefined)
+          character.personaProfile = payload.personaProfile
         character.updatedAt = new Date()
         characters.value.set(character.id, character)
         await charactersRepo.upsert(character)
diff --git a/packages/stage-ui/src/types/character.ts b/packages/stage-ui/src/types/character.ts
index 004e3e8559..74cf0e9f17 100644
--- a/packages/stage-ui/src/types/character.ts
+++ b/packages/stage-ui/src/types/character.ts
@@ -1,6 +1,6 @@
 import type { InferOutput } from 'valibot'
 
-import { array, date, literal, number, object, optional, pipe, string, transform, union } from 'valibot'
+import { array, boolean, date, literal, number, object, optional, pipe, string, transform, union } from 'valibot'
 
 // --- Enums & Configs ---
 
@@ -52,6 +52,30 @@ const PromptTypeSchema = union([
   literal('greetings'),
 ])
 
+const CharacterVisibilitySchema = union([
+  literal('private'),
+  literal('public'),
+  literal('unlisted'),
+])
+
+const CharacterNsfwLevelSchema = union([
+  literal('none'),
+  literal('suggestive'),
+  literal('explicit'),
+])
+
+const CharacterRelationshipModeSchema = union([
+  literal('companion'),
+  literal('romance'),
+  literal('roleplay'),
+])
+
+const CharacterMemoryProfileSchema = union([
+  literal('light'),
+  literal('standard'),
+  literal('deep'),
+])
+
 const DateSchema = pipe(
   union([string(), date()]),
   transform(v => new Date(v)),
@@ -68,10 +92,23 @@ export const CharacterBaseSchema = object({
   coverBackgroundUrl: optional(string()),
   creatorRole: optional(string()),
   priceCredit: string(),
+  visibility: CharacterVisibilitySchema,
+  nsfwEnabled: boolean(),
+  nsfwLevel: CharacterNsfwLevelSchema,
+  relationshipMode: CharacterRelationshipModeSchema,
   likesCount: number(),
   bookmarksCount: number(),
   interactionsCount: number(),
   forksCount: number(),
+  personaProfile: object({
+    personality: optional(string()),
+    scenario: optional(string()),
+    speakingStyle: optional(string()),
+    traits: optional(array(string())),
+    boundaries: optional(array(string())),
+    starterMessages: optional(array(string())),
+    memoryProfile: optional(CharacterMemoryProfileSchema),
+  }),
   creatorId: string(),
   ownerId: string(),
   characterId: string(),
@@ -138,6 +175,19 @@ export const CreateCharacterSchema = object({
     version: string(),
     coverUrl: string(),
     characterId: string(),
+    visibility: optional(CharacterVisibilitySchema),
+    nsfwEnabled: optional(boolean()),
+    nsfwLevel: optional(CharacterNsfwLevelSchema),
+    relationshipMode: optional(CharacterRelationshipModeSchema),
+    personaProfile: optional(object({
+      personality: optional(string()),
+      scenario: optional(string()),
+      speakingStyle: optional(string()),
+      traits: optional(array(string())),
+      boundaries: optional(array(string())),
+      starterMessages: optional(array(string())),
+      memoryProfile: optional(CharacterMemoryProfileSchema),
+    })),
     // creatorId & ownerId are handled by server
   }),
   capabilities: optional(array(object({
@@ -167,6 +217,19 @@ export const UpdateCharacterSchema = object({
   version: optional(string()),
   coverUrl: optional(string()),
   characterId: optional(string()),
+  visibility: optional(CharacterVisibilitySchema),
+  nsfwEnabled: optional(boolean()),
+  nsfwLevel: optional(CharacterNsfwLevelSchema),
+  relationshipMode: optional(CharacterRelationshipModeSchema),
+  personaProfile: optional(object({
+    personality: optional(string()),
+    scenario: optional(string()),
+    speakingStyle: optional(string()),
+    traits: optional(array(string())),
+    boundaries: optional(array(string())),
+    starterMessages: optional(array(string())),
+    memoryProfile: optional(CharacterMemoryProfileSchema),
+  })),
 })
 
 // --- Type Exports ---

From ecdf99c0a180b96a92ba73873f20716ab8ecc708 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Mon, 30 Mar 2026 15:37:49 +0200
Subject: [PATCH 02/30] feat: Add Candy-style character metadata and consumer
 pages

- Character schema: visibility, nsfwEnabled, nsfwLevel, relationshipMode, personaProfile
- CharacterDialog: persona tab, NSFW controls, relationship settings
- CharacterItem: badges for relationship/visibility/NSFW
- v2/index.vue: filters, hero, categorization
- v2/[id].vue: character detail page with scenario, starters, boundaries
- Migration: 0008_lazy_wallflower.sql

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .../characters/components/CharacterDialog.vue |  37 ++----
 .../src/pages/settings/characters/index.vue   |  11 +-
 packages/stage-pages/src/pages/nsfw/index.vue |  51 ++++++++
 packages/stage-pages/src/pages/v2/[id].vue    |  10 +-
 packages/stage-pages/src/pages/v2/index.vue   |   7 +-
 packages/stage-ui/src/stores/characters.ts    | 114 +++++++++++++++++-
 6 files changed, 192 insertions(+), 38 deletions(-)
 create mode 100644 packages/stage-pages/src/pages/nsfw/index.vue

diff --git a/apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue b/apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue
index 1c8ed84303..4981f193e8 100644
--- a/apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue
+++ b/apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue
@@ -13,6 +13,7 @@ import {
 } from 'reka-ui'
 import { safeParse } from 'valibot'
 import { computed, reactive, ref, watch } from 'vue'
+import { RouterLink } from 'vue-router'
 
 interface Props {
   modelValue: boolean
@@ -33,8 +34,6 @@ const form = reactive({
   version: '1.0.0',
   coverUrl: '',
   visibility: 'private' as 'private' | 'public' | 'unlisted',
-  nsfwEnabled: false,
-  nsfwLevel: 'none' as 'none' | 'suggestive' | 'explicit',
   relationshipMode: 'companion' as 'companion' | 'romance' | 'roleplay',
   name: '',
   description: '',
@@ -64,8 +63,6 @@ watch(() => props.character, (char) => {
     form.version = char.version
     form.coverUrl = char.coverUrl
     form.visibility = char.visibility
-    form.nsfwEnabled = char.nsfwEnabled
-    form.nsfwLevel = char.nsfwLevel
     form.relationshipMode = char.relationshipMode
     form.name = i18n?.name || ''
     form.description = i18n?.description || ''
@@ -87,8 +84,6 @@ watch(() => props.character, (char) => {
     form.version = '1.0.0'
     form.coverUrl = ''
     form.visibility = 'private'
-    form.nsfwEnabled = false
-    form.nsfwLevel = 'none'
     form.relationshipMode = 'companion'
     form.name = ''
     form.description = ''
@@ -118,8 +113,6 @@ async function handleSubmit() {
       version: form.version,
       coverUrl: form.coverUrl,
       visibility: form.visibility,
-      nsfwEnabled: form.nsfwEnabled,
-      nsfwLevel: form.nsfwLevel,
       relationshipMode: form.relationshipMode,
       personaProfile: {
         personality: form.personality || undefined,
@@ -197,8 +190,6 @@ async function handleSubmit() {
         version: form.version,
         coverUrl: form.coverUrl,
         visibility: form.visibility,
-        nsfwEnabled: form.nsfwEnabled,
-        nsfwLevel: form.nsfwLevel,
         relationshipMode: form.relationshipMode,
         personaProfile: {
           personality: form.personality || undefined,
@@ -330,26 +321,12 @@ const isOpen = computed({
                   </div>
                 </div>
 
-                <div class="grid grid-cols-[auto,1fr] items-center gap-4 rounded-xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800/60">
-                  <label class="text-sm text-neutral-700 font-medium dark:text-neutral-300">Enable NSFW</label>
-                  <div class="flex items-center justify-end">
-                    <input v-model="form.nsfwEnabled" type="checkbox" class="h-4 w-4 rounded border-neutral-300 text-primary-600 focus:ring-primary-500">
-                  </div>
-                </div>
-
-                <div class="flex flex-col gap-1.5">
-                  <label class="text-sm text-neutral-700 font-medium dark:text-neutral-300">NSFW Level</label>
-                  <select v-model="form.nsfwLevel" :disabled="!form.nsfwEnabled" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none disabled:cursor-not-allowed disabled:opacity-50 dark:border-neutral-700 focus:border-primary-500 dark:bg-neutral-800 focus:ring-2 focus:ring-primary-500/20">
-                    <option value="none">
-                      None
-                    </option>
-                    <option value="suggestive">
-                      Suggestive
-                    </option>
-                    <option value="explicit">
-                      Explicit
-                    </option>
-                  </select>
+                <div class="rounded-xl bg-neutral-50 px-4 py-3 text-sm text-neutral-600 leading-6 dark:bg-neutral-800/60 dark:text-neutral-300">
+                  NSFW-specific settings live in the separate
+                  <RouterLink to="/nsfw" class="text-primary-600 font-medium underline decoration-dotted dark:text-primary-400">
+                    NSFW workspace
+                  </RouterLink>
+                  so your normal character flow stays clean.
                 </div>
               </div>
 
diff --git a/apps/stage-web/src/pages/settings/characters/index.vue b/apps/stage-web/src/pages/settings/characters/index.vue
index 345f617168..fec067b11b 100644
--- a/apps/stage-web/src/pages/settings/characters/index.vue
+++ b/apps/stage-web/src/pages/settings/characters/index.vue
@@ -5,12 +5,14 @@ import { useCharacterStore } from '@proj-airi/stage-ui/stores/characters'
 import { Button, FieldInput } from '@proj-airi/ui'
 import { storeToRefs } from 'pinia'
 import { computed, onMounted, ref } from 'vue'
+import { useRouter } from 'vue-router'
 
 import CharacterDialog from './components/CharacterDialog.vue'
 import CharacterItem from './components/CharacterItem.vue'
 
 const characterStore = useCharacterStore()
 const { characters } = storeToRefs(characterStore)
+const router = useRouter()
 
 // Fetch on mount
 onMounted(() => {
@@ -49,10 +51,9 @@ function handleDelete(id: string) {
   }
 }
 
-function handleActivate(char: Character) {
-  // TODO: Implement activation logic (global store for active character)
-  // eslint-disable-next-line no-console
-  console.log('Activate', char.id)
+async function handleActivate(char: Character) {
+  await characterStore.activateCharacter(char.id)
+  router.push('/')
 }
 </script>
 
@@ -107,7 +108,7 @@ function handleActivate(char: Character) {
         v-for="char in filteredCharacters"
         :key="char.id"
         :character="char"
-        :is-active="false"
+        :is-active="characterStore.isCharacterActive(char.id)"
         :is-selected="selectedCharacter?.id === char.id"
         @select="handleEdit(char)"
         @activate="handleActivate(char)"
diff --git a/packages/stage-pages/src/pages/nsfw/index.vue b/packages/stage-pages/src/pages/nsfw/index.vue
new file mode 100644
index 0000000000..ebcba2a38e
--- /dev/null
+++ b/packages/stage-pages/src/pages/nsfw/index.vue
@@ -0,0 +1,51 @@
+<template>
+  <div class="min-h-screen px-4 py-10 md:px-8">
+    <div mx-auto max-w-5xl class="space-y-6">
+      <section class="rounded-[2rem] bg-linear-to-br from-neutral-950 via-neutral-900 to-rose-950 px-6 py-8 text-white shadow-sm">
+        <div class="max-w-3xl">
+          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.16em] backdrop-blur">
+            Separate NSFW Workspace
+          </div>
+          <h1 class="text-4xl font-semibold md:text-5xl">
+            Keep NSFW separate from the normal product flow
+          </h1>
+          <p class="mt-4 max-w-2xl text-sm text-white/75 leading-6 md:text-base">
+            This area is reserved for NSFW-specific routes, character controls, prompts, gallery behavior, and moderation policy so your regular companion UX stays clean.
+          </p>
+        </div>
+      </section>
+
+      <section class="grid gap-4 md:grid-cols-3">
+        <div class="rounded-[1.5rem] bg-white p-5 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+          <h2 class="text-lg font-semibold">
+            Character Access
+          </h2>
+          <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+            Per-character NSFW enablement, explicitness level, and separate onboarding or gating.
+          </p>
+        </div>
+        <div class="rounded-[1.5rem] bg-white p-5 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+          <h2 class="text-lg font-semibold">
+            Prompt Layer
+          </h2>
+          <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+            Separate routing, style controls, and policy logic without mixing it into normal companion prompts.
+          </p>
+        </div>
+        <div class="rounded-[1.5rem] bg-white p-5 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+          <h2 class="text-lg font-semibold">
+            Gallery & Media
+          </h2>
+          <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+            Reserved for image generation, galleries, and other NSFW-specific media workflows.
+          </p>
+        </div>
+      </section>
+    </div>
+  </div>
+</template>
+
+<route lang="yaml">
+meta:
+  title: NSFW Workspace
+</route>
diff --git a/packages/stage-pages/src/pages/v2/[id].vue b/packages/stage-pages/src/pages/v2/[id].vue
index da302bf24a..fddda82101 100644
--- a/packages/stage-pages/src/pages/v2/[id].vue
+++ b/packages/stage-pages/src/pages/v2/[id].vue
@@ -45,6 +45,14 @@ const starterMessages = computed(() => character.value?.personaProfile?.starterM
 const boundaries = computed(() => character.value?.personaProfile?.boundaries || [])
 const liked = computed(() => !!character.value?.likes?.some(item => item.userId === authStore.user?.id))
 const bookmarked = computed(() => !!character.value?.bookmarks?.some(item => item.userId === authStore.user?.id))
+
+async function enterStage() {
+  if (!character.value)
+    return
+
+  await characterStore.activateCharacter(character.value.id)
+  router.push('/')
+}
 </script>
 
 <template>
@@ -128,7 +136,7 @@ const bookmarked = computed(() => !!character.value?.bookmarks?.some(item => ite
             </div>
 
             <div class="flex flex-wrap gap-3">
-              <Button @click="router.push('/')">
+              <Button @click="enterStage">
                 Enter Stage
               </Button>
               <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/settings/characters')">
diff --git a/packages/stage-pages/src/pages/v2/index.vue b/packages/stage-pages/src/pages/v2/index.vue
index 9e9fe75eb7..3610f91c8d 100644
--- a/packages/stage-pages/src/pages/v2/index.vue
+++ b/packages/stage-pages/src/pages/v2/index.vue
@@ -41,6 +41,11 @@ onMounted(() => {
   characterStore.fetchList(true)
 })
 
+async function openCharacter(id: string) {
+  await characterStore.activateCharacter(id)
+  router.push(`/v2/${id}`)
+}
+
 const characters = computed(() => Array.from(characterStore.characters.values())
   .filter((char) => {
     if (activeFilter.value === 'all')
@@ -284,7 +289,7 @@ const filters = [
                         'pl-1.5 pr-2 py-1 rounded-full',
                         'bg-neutral-900/50',
                       ]"
-                      @click="router.push(`/v2/${character.id}`)"
+                      @click="openCharacter(character.id)"
                     >
                       <div :class="['i-solar:chat-square-bold text-xs inline-block text-neutral-100 dark:text-neutral-900']" />
                       <span :class="['text-xs', 'text-neutral-100 dark:text-neutral-900']">Open</span>
diff --git a/packages/stage-ui/src/stores/characters.ts b/packages/stage-ui/src/stores/characters.ts
index 7696baad1a..251c1659ad 100644
--- a/packages/stage-ui/src/stores/characters.ts
+++ b/packages/stage-ui/src/stores/characters.ts
@@ -1,15 +1,18 @@
+import type { Card } from '@proj-airi/ccc'
 import type { Character, CreateCharacterPayload, UpdateCharacterPayload } from '../types/character'
 
+import { useLocalStorage } from '@vueuse/core'
 import { nanoid } from 'nanoid'
 import { defineStore } from 'pinia'
 import { parse } from 'valibot'
-import { ref } from 'vue'
+import { computed, ref } from 'vue'
 
 import { client } from '../composables/api'
 import { useLocalFirstRequest } from '../composables/use-local-first'
 import { charactersRepo } from '../database/repos/characters.repo'
 import { CharacterWithRelationsSchema } from '../types/character'
 import { useAuthStore } from './auth'
+import { useAiriCardStore } from './modules/airi-card'
 
 function buildLocalCharacter(userId: string, payload: CreateCharacterPayload) {
   const id = payload.character.id ?? nanoid()
@@ -80,6 +83,108 @@ function buildLocalCharacter(userId: string, payload: CreateCharacterPayload) {
 export const useCharacterStore = defineStore('characters', () => {
   const characters = ref<Map<string, Character>>(new Map())
   const auth = useAuthStore()
+  const cardStore = useAiriCardStore()
+  const runtimeCardLinks = useLocalStorage<Record<string, string>>('characters/v1/runtime-card-links', {})
+
+  function getCharacterDisplayInfo(character: Character) {
+    const i18n = character.i18n?.find(item => item.language === 'en') || character.i18n?.[0]
+    return {
+      name: i18n?.name || character.characterId,
+      description: i18n?.description || '',
+      tags: i18n?.tags || [],
+    }
+  }
+
+  function buildRuntimeCard(character: Character): Card {
+    const info = getCharacterDisplayInfo(character)
+    const llmCapability = character.capabilities?.find(capability => capability.type === 'llm')
+    const ttsCapability = character.capabilities?.find(capability => capability.type === 'tts')
+    const greetings = character.personaProfile?.starterMessages?.length
+      ? character.personaProfile.starterMessages
+      : character.prompts
+          ?.filter(prompt => prompt.type === 'greetings')
+          .map(prompt => prompt.content)
+          .filter(Boolean)
+
+    return {
+      name: info.name,
+      version: character.version,
+      creator: character.creatorRole || 'AIRI Character',
+      description: info.description,
+      personality: character.personaProfile?.personality || info.description,
+      scenario: character.personaProfile?.scenario,
+      systemPrompt: character.prompts?.find(prompt => prompt.type === 'system')?.content,
+      greetings,
+      tags: [
+        ...info.tags,
+        character.relationshipMode,
+        ...(character.nsfwEnabled ? [character.nsfwLevel] : []),
+      ].filter(Boolean),
+      metadata: {
+        source: 'character-store',
+        sourceCharacterId: character.id,
+      },
+      extensions: {
+        airi: {
+          modules: {
+            consciousness: {
+              provider: cardStore.currentModels.consciousness.provider,
+              model: llmCapability?.config.llm?.model || cardStore.currentModels.consciousness.model,
+            },
+            speech: {
+              provider: cardStore.currentModels.speech.provider,
+              model: cardStore.currentModels.speech.model,
+              voice_id: ttsCapability?.config.tts?.voiceId || cardStore.currentModels.speech.voice_id,
+              pitch: ttsCapability?.config.tts?.pitch,
+              rate: ttsCapability?.config.tts?.speed,
+              ssml: !!ttsCapability?.config.tts?.ssml,
+            },
+            displayModelId: cardStore.currentModels.displayModelId,
+          },
+          agents: {},
+        },
+      },
+    }
+  }
+
+  function ensureRuntimeCard(character: Character) {
+    const existingCardId = runtimeCardLinks.value[character.id]
+    const runtimeCard = buildRuntimeCard(character)
+
+    if (existingCardId && cardStore.getCard(existingCardId)) {
+      cardStore.updateCard(existingCardId, runtimeCard)
+      return existingCardId
+    }
+
+    const newCardId = cardStore.addCard(runtimeCard)
+    runtimeCardLinks.value = {
+      ...runtimeCardLinks.value,
+      [character.id]: newCardId,
+    }
+    return newCardId
+  }
+
+  async function activateCharacter(id: string) {
+    let character = characters.value.get(id)
+    if (!character)
+      character = await fetchById(id)
+
+    if (!character)
+      throw new Error('Character not found')
+
+    const runtimeCardId = ensureRuntimeCard(character)
+    cardStore.activeCardId = runtimeCardId
+    return runtimeCardId
+  }
+
+  function isCharacterActive(id: string) {
+    return runtimeCardLinks.value[id] != null && runtimeCardLinks.value[id] === cardStore.activeCardId
+  }
+
+  const activeCharacterId = computed(() => {
+    const entry = Object.entries(runtimeCardLinks.value).find(([, cardId]) => cardId === cardStore.activeCardId)
+    return entry?.[0] || null
+  })
 
   async function fetchList(all: boolean = false) {
     return useLocalFirstRequest({
@@ -194,6 +299,8 @@ export const useCharacterStore = defineStore('characters', () => {
         character.updatedAt = new Date()
         characters.value.set(character.id, character)
         await charactersRepo.upsert(character)
+        if (isCharacterActive(character.id))
+          ensureRuntimeCard(character)
         return character
       },
       remote: async () => {
@@ -210,6 +317,8 @@ export const useCharacterStore = defineStore('characters', () => {
 
         characters.value.set(character.id, character)
         await charactersRepo.upsert(character)
+        if (isCharacterActive(character.id))
+          ensureRuntimeCard(character)
         return character
       },
     })
@@ -304,6 +413,7 @@ export const useCharacterStore = defineStore('characters', () => {
 
   return {
     characters,
+    activeCharacterId,
 
     fetchList,
     fetchById,
@@ -312,6 +422,8 @@ export const useCharacterStore = defineStore('characters', () => {
     remove,
     like,
     bookmark,
+    activateCharacter,
+    isCharacterActive,
     getCharacter,
   }
 })

From bf61307e5b3f2ce78753b1dbdea7aa26ee385f8e Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Mon, 30 Mar 2026 18:54:55 +0200
Subject: [PATCH 03/30] feat: add nsfw companion runtime integration

---
 apps/server/drizzle/0009_nsfw_user_gating.sql |   8 +
 apps/server/drizzle/meta/_journal.json        |   7 +
 apps/server/src/app.ts                        |   9 +
 apps/server/src/routes/users/index.ts         |  45 ++
 apps/server/src/routes/users/schema.ts        |  11 +
 apps/server/src/schemas/accounts.ts           |   5 +
 docs/content/en/nsfw-companion-index.md       | 189 ++++++
 docs/content/en/nsfw-companion-stack.md       | 466 +++++++++++++
 docs/content/en/nsfw-companion-todo.md        |  82 +++
 packages/server-schema/package.json           |   3 +
 packages/server-schema/src/hermes-contract.ts | 157 +++++
 packages/server-schema/src/index.ts           |   1 +
 packages/server-sdk-shared/src/index.ts       |  66 ++
 packages/stage-pages/src/pages/nsfw/[id].vue  | 235 +++++++
 packages/stage-pages/src/pages/nsfw/index.vue | 638 +++++++++++++++++-
 .../src/pages/settings/account.vue            | 101 +++
 packages/stage-ui/package.json                |   1 +
 packages/stage-ui/src/libs/auth.ts            |   4 +
 .../stage-ui/src/libs/hermes-transport.ts     |  88 +++
 packages/stage-ui/src/libs/hermes.ts          |  94 +++
 packages/stage-ui/src/libs/index.ts           |   2 +
 packages/stage-ui/src/libs/server.ts          |   2 +
 packages/stage-ui/src/stores/auth.ts          |  54 ++
 packages/stage-ui/src/stores/chat.ts          | 140 ++++
 .../src/stores/chat/hermes-memory-store.ts    |  91 +++
 25 files changed, 2476 insertions(+), 23 deletions(-)
 create mode 100644 apps/server/drizzle/0009_nsfw_user_gating.sql
 create mode 100644 apps/server/src/routes/users/index.ts
 create mode 100644 apps/server/src/routes/users/schema.ts
 create mode 100644 docs/content/en/nsfw-companion-index.md
 create mode 100644 docs/content/en/nsfw-companion-stack.md
 create mode 100644 docs/content/en/nsfw-companion-todo.md
 create mode 100644 packages/server-schema/src/hermes-contract.ts
 create mode 100644 packages/stage-pages/src/pages/nsfw/[id].vue
 create mode 100644 packages/stage-pages/src/pages/settings/account.vue
 create mode 100644 packages/stage-ui/src/libs/hermes-transport.ts
 create mode 100644 packages/stage-ui/src/libs/hermes.ts
 create mode 100644 packages/stage-ui/src/stores/chat/hermes-memory-store.ts

diff --git a/apps/server/drizzle/0009_nsfw_user_gating.sql b/apps/server/drizzle/0009_nsfw_user_gating.sql
new file mode 100644
index 0000000000..6ab3d5e6f7
--- /dev/null
+++ b/apps/server/drizzle/0009_nsfw_user_gating.sql
@@ -0,0 +1,8 @@
+ALTER TABLE "user"
+  ADD COLUMN "adult_verified" boolean DEFAULT false NOT NULL;
+
+ALTER TABLE "user"
+  ADD COLUMN "allow_sensitive_content" boolean DEFAULT false NOT NULL;
+
+ALTER TABLE "user"
+  ADD COLUMN "content_tier" text DEFAULT 'standard' NOT NULL;
diff --git a/apps/server/drizzle/meta/_journal.json b/apps/server/drizzle/meta/_journal.json
index 2732d7165c..bf39c3249f 100644
--- a/apps/server/drizzle/meta/_journal.json
+++ b/apps/server/drizzle/meta/_journal.json
@@ -64,6 +64,13 @@
       "when": 1774800000000,
       "tag": "0008_lazy_wallflower",
       "breakpoints": true
+    },
+    {
+      "idx": 9,
+      "version": "7",
+      "when": 1774803600000,
+      "tag": "0009_nsfw_user_gating",
+      "breakpoints": true
     }
   ]
 }
diff --git a/apps/server/src/app.ts b/apps/server/src/app.ts
index de5b536399..ce46b20487 100644
--- a/apps/server/src/app.ts
+++ b/apps/server/src/app.ts
@@ -10,6 +10,7 @@ import type { ChatService } from './services/chats'
 import type { ConfigKVService } from './services/config-kv'
 import type { FluxService } from './services/flux'
 import type { FluxTransactionService } from './services/flux-transaction'
+import type { Database } from './libs/db'
 import type { ProviderService } from './services/providers'
 import type { StripeService } from './services/stripe'
 import type { HonoEnv } from './types/hono'
@@ -41,6 +42,7 @@ import { createFluxRoutes } from './routes/flux'
 import { createV1CompletionsRoutes } from './routes/openai/v1'
 import { createProviderRoutes } from './routes/providers'
 import { createStripeRoutes } from './routes/stripe'
+import { createUserRoutes } from './routes/users'
 import { createBillingMq } from './services/billing/billing-events'
 import { createBillingService } from './services/billing/billing-service'
 import { createCharacterService } from './services/characters'
@@ -55,6 +57,7 @@ import { ApiError, createInternalError, createUnauthorizedError } from './utils/
 import { getTrustedOrigin } from './utils/origin'
 
 interface AppDeps {
+  db: Database
   auth: ReturnType<typeof createAuth>
   characterService: CharacterService
   chatService: ChatService
@@ -191,6 +194,11 @@ async function buildApp(deps: AppDeps) {
      */
     .route('/api/v1/providers', createProviderRoutes(deps.providerService))
 
+    /**
+     * Current user settings routes.
+     */
+    .route('/api/v1/users', createUserRoutes(deps.db))
+
     /**
      * Chat routes are handled by the chat service.
      */
@@ -370,6 +378,7 @@ export async function createApp() {
     otel,
   })
   const { app, injectWebSocket } = await buildApp({
+    db: resolved.db,
     auth: resolved.auth,
     characterService: resolved.characterService,
     chatService: resolved.chatService,
diff --git a/apps/server/src/routes/users/index.ts b/apps/server/src/routes/users/index.ts
new file mode 100644
index 0000000000..1a14d08a4e
--- /dev/null
+++ b/apps/server/src/routes/users/index.ts
@@ -0,0 +1,45 @@
+import type { Database } from '../../libs/db'
+import type { HonoEnv } from '../../types/hono'
+
+import { eq } from 'drizzle-orm'
+import { Hono } from 'hono'
+import { safeParse } from 'valibot'
+
+import { authGuard } from '../../middlewares/auth'
+import { user } from '../../schemas/accounts'
+import { createBadRequestError } from '../../utils/error'
+import { UpdateCurrentUserSchema } from './schema'
+
+export function createUserRoutes(db: Database) {
+  return new Hono<HonoEnv>()
+    .use('*', authGuard)
+
+    .get('/me', async (c) => {
+      const sessionUser = c.get('user')!
+      const [currentUser] = await db
+        .select()
+        .from(user)
+        .where(eq(user.id, sessionUser.id))
+        .limit(1)
+
+      return c.json(currentUser)
+    })
+
+    .patch('/me', async (c) => {
+      const sessionUser = c.get('user')!
+      const body = await c.req.json()
+      const result = safeParse(UpdateCurrentUserSchema, body)
+
+      if (!result.success) {
+        throw createBadRequestError('Invalid Request', 'INVALID_REQUEST', result.issues)
+      }
+
+      const [updated] = await db
+        .update(user)
+        .set(result.output)
+        .where(eq(user.id, sessionUser.id))
+        .returning()
+
+      return c.json(updated)
+    })
+}
diff --git a/apps/server/src/routes/users/schema.ts b/apps/server/src/routes/users/schema.ts
new file mode 100644
index 0000000000..5c43618ab9
--- /dev/null
+++ b/apps/server/src/routes/users/schema.ts
@@ -0,0 +1,11 @@
+import { boolean, literal, object, union } from 'valibot'
+
+export const UpdateCurrentUserSchema = object({
+  adultVerified: boolean(),
+  allowSensitiveContent: boolean(),
+  contentTier: union([
+    literal('standard'),
+    literal('sensitive'),
+    literal('explicit'),
+  ]),
+})
diff --git a/apps/server/src/schemas/accounts.ts b/apps/server/src/schemas/accounts.ts
index b638d84385..3749cf53c1 100644
--- a/apps/server/src/schemas/accounts.ts
+++ b/apps/server/src/schemas/accounts.ts
@@ -1,11 +1,16 @@
 import { relations } from 'drizzle-orm'
 import { boolean, index, pgTable, text, timestamp } from 'drizzle-orm/pg-core'
 
+const contentTierEnum = ['standard', 'sensitive', 'explicit'] as const
+
 export const user = pgTable('user', {
   id: text('id').primaryKey(),
   name: text('name').notNull(),
   email: text('email').notNull().unique(),
   emailVerified: boolean('email_verified').default(false).notNull(),
+  adultVerified: boolean('adult_verified').default(false).notNull(),
+  allowSensitiveContent: boolean('allow_sensitive_content').default(false).notNull(),
+  contentTier: text('content_tier', { enum: contentTierEnum }).default('standard').notNull(),
   image: text('image'),
   createdAt: timestamp('created_at').defaultNow().notNull(),
   updatedAt: timestamp('updated_at')
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
new file mode 100644
index 0000000000..91b66feb75
--- /dev/null
+++ b/docs/content/en/nsfw-companion-index.md
@@ -0,0 +1,189 @@
+# AIRI + Hermes NSFW Companion Index
+
+This is the file and feature index for the current AIRI + Hermes companion stack.
+
+## Repos
+
+### AIRI
+
+Root: `/home/faramix/airi`
+
+Role:
+
+- product UI
+- route split
+- account and character data
+- chat session state
+- Hermes request building
+- NSFW gating surface
+
+### Hermes Agent
+
+Root: `/home/faramix/hermes-agent`
+
+Role:
+
+- runtime routing
+- memory selection
+- context assembly
+- reply assembly
+- HTTP bridge for AIRI
+
+## AIRI File Index
+
+### Contracts
+
+- `packages/server-schema/src/hermes-contract.ts`
+  - shared request and response schema for AIRI to Hermes
+- `packages/server-schema/src/index.ts`
+  - schema exports
+- `packages/server-sdk-shared/src/index.ts`
+  - shared invoke contract name `hermes:generate-reply`
+
+### Chat and Hermes Transport
+
+- `packages/stage-ui/src/libs/hermes.ts`
+  - converts AIRI session data into Hermes request payloads
+- `packages/stage-ui/src/libs/hermes-transport.ts`
+  - HTTP transport helper and local stub fallback
+- `packages/stage-ui/src/libs/server.ts`
+  - `HERMES_URL`
+  - `USE_HERMES_CHAT`
+- `packages/stage-ui/src/stores/chat.ts`
+  - builds Hermes payloads from active sessions
+  - sends chat turns through Hermes when enabled
+  - applies Hermes memory updates
+- `packages/stage-ui/src/stores/chat/hermes-memory-store.ts`
+  - per-session local persistence for summaries and facts
+
+### Auth and User Gating
+
+- `apps/server/src/schemas/accounts.ts`
+  - adds:
+    - `adultVerified`
+    - `allowSensitiveContent`
+    - `contentTier`
+- `apps/server/drizzle/0009_nsfw_user_gating.sql`
+  - migration for user gating fields
+- `apps/server/src/routes/users/schema.ts`
+  - user profile request validation
+- `apps/server/src/routes/users/index.ts`
+  - `GET /api/v1/users/me`
+  - `PATCH /api/v1/users/me`
+- `packages/stage-ui/src/stores/auth.ts`
+  - profile fetch and update
+  - computed access flags
+- `packages/stage-ui/src/libs/auth.ts`
+  - loads user profile after auth session
+- `packages/stage-pages/src/pages/settings/account.vue`
+  - UI for user-level gating flags
+
+### Character Data and NSFW Metadata
+
+- `apps/server/src/schemas/characters.ts`
+  - adds:
+    - `visibility`
+    - `nsfwEnabled`
+    - `nsfwLevel`
+    - `relationshipMode`
+    - `personaProfile`
+- `apps/server/src/routes/characters/schema.ts`
+  - validates new character metadata
+- `apps/server/drizzle/0008_lazy_wallflower.sql`
+  - character metadata migration
+- `packages/stage-ui/src/types/character.ts`
+  - frontend types for new character fields
+- `packages/stage-ui/src/stores/characters.ts`
+  - store support for metadata and activation
+
+### Consumer and NSFW Surface
+
+- `packages/stage-pages/src/pages/v2/index.vue`
+  - upgraded explore page
+- `packages/stage-pages/src/pages/v2/[id].vue`
+  - character detail page
+- `packages/stage-pages/src/pages/nsfw/index.vue`
+  - separate NSFW surface
+  - guarded by user access flags
+  - includes character-level NSFW editor
+- `packages/stage-pages/src/pages/nsfw/[id].vue`
+  - separate NSFW detail page
+- `apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue`
+  - general creator dialog without direct NSFW clutter
+- `apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue`
+  - richer card metadata
+
+## Hermes Agent File Index
+
+### Types and Runtime
+
+- `agent/airi_types.py`
+  - shared dataclasses matching the AIRI contract
+- `agent/airi_runtime.py`
+  - orchestrates scene routing, memory selection, context assembly, reply building, and memory updates
+
+### Runtime Services
+
+- `agent/airi_scene_router.py`
+  - detects:
+    - `general`
+    - `romance`
+    - `roleplay`
+    - `support`
+    - `nsfw`
+  - computes:
+    - intensity
+    - softening
+    - NSFW blocking
+    - matched signals
+- `agent/airi_memory_service.py`
+  - selects session facts
+  - extracts user preferences from recent turns
+  - creates memory updates after each reply
+- `agent/airi_context_assembler.py`
+  - combines route policy, persona notes, memory notes, recent dialogue, and latest input
+  - keeps NSFW prompts grounded in boundaries and continuity
+- `agent/airi_reply_service.py`
+  - builds persona-aware deterministic replies
+  - references scenario, speaking style, starter messages, boundaries, memory, and assembled context
+  - returns judge flags for thin or mirrored responses
+
+### HTTP Bridge
+
+- `agent/airi_http_service.py`
+  - `GET /health`
+  - `POST /v1/airi/generate-reply`
+
+## Current State
+
+### Implemented
+
+- shared AIRI to Hermes contract
+- separate normal and NSFW surface
+- user-level NSFW gating
+- character-level NSFW metadata and editor
+- Hermes HTTP bridge
+- Hermes scene routing
+- Hermes memory selection
+- Hermes context assembly
+- Hermes deterministic reply assembly
+- Hermes memory delta return path into AIRI
+
+### Still Open
+
+- server-side long-term memory
+- quality judge beyond simple heuristic flags
+- image prompt generation
+- gallery and generate routes
+- premium gating for NSFW media actions
+- actual model wiring to `Hermes-4.3-36B`, `Grok 4.20`, and `GPT-5 mini`
+- build, typecheck, and tests once dependencies are installed
+
+## Canonical Docs
+
+- `docs/content/en/nsfw-companion-stack.md`
+  - stack decisions and model strategy
+- `docs/content/en/nsfw-companion-todo.md`
+  - implementation checklist
+- `docs/content/en/nsfw-companion-index.md`
+  - this file index
diff --git a/docs/content/en/nsfw-companion-stack.md b/docs/content/en/nsfw-companion-stack.md
new file mode 100644
index 0000000000..e4ab73430b
--- /dev/null
+++ b/docs/content/en/nsfw-companion-stack.md
@@ -0,0 +1,466 @@
+# AIRI + Hermes NSFW Companion Stack
+
+This document defines the recommended production stack for running AIRI as the consumer app and Hermes Agent as the runtime/orchestration layer for both normal and NSFW companion flows.
+
+## Goals
+
+- Keep the normal AIRI product surface clean.
+- Keep NSFW routes and policy separate.
+- Use a strong self-hosted reply model for companion quality.
+- Use stronger API models only where they create clear leverage.
+- Avoid a single-model architecture.
+
+## Repo Ownership
+
+### AIRI
+
+`/home/faramix/airi`
+
+Owns:
+
+- web and app UI
+- explore pages
+- character profile pages
+- chat UI
+- billing and credits UX
+- gallery UX
+- image generation UX
+- user and character records
+- chat records
+- subscriptions and entitlements
+- normal routes
+- NSFW routes under `/nsfw`
+
+### Hermes Agent
+
+`/home/faramix/hermes-agent`
+
+Owns:
+
+- routing and orchestration
+- tool execution
+- memory summarization
+- retrieval planning
+- cross-channel messaging
+- creator copilot
+- support and moderation ops
+- scheduled jobs
+- image prompt planning
+- quality judging
+
+## Route Split
+
+### Normal
+
+Use AIRI routes like:
+
+- `/v2`
+- `/v2/:id`
+- `/chat/:id`
+
+Characteristics:
+
+- general companion discovery
+- non-explicit profiles
+- safer routing policy
+- no explicit media surface
+
+### NSFW
+
+Use AIRI routes like:
+
+- `/nsfw`
+- `/nsfw/:id`
+- future `/nsfw/gallery`
+- future `/nsfw/generate`
+
+Characteristics:
+
+- explicit character discovery
+- explicit persona metadata
+- separate routing and escalation logic
+- separate image/gallery policy
+- separate analytics and feature gating
+
+## Model Matrix
+
+### Recommended Production Setup
+
+- `main reply model`: `NousResearch/Hermes-4.3-36B`
+- `router / planner / evaluator`: `Grok 4.20`
+- `memory summarizer / fact extractor`: `GPT-5 mini`
+- `creator/admin copilot`: `GPT-5.4` or `Claude Sonnet 4`
+- `image prompt writer`: `GPT-5.4` or `Grok 4.20`
+
+### Why
+
+#### Hermes-4.3-36B
+
+Use for final character replies.
+
+Why:
+
+- open and self-hostable
+- explicitly strong at roleplay and conversational output
+- structured output support
+- lower refusal profile than closed safety-heavy models
+- easier to steer with character-specific prompts
+
+Official sources:
+
+- https://huggingface.co/NousResearch/Hermes-4.3-36B
+- https://huggingface.co/NousResearch/Hermes-4.3-36B-GGUF
+
+#### Grok 4.20
+
+Use for routing, scene classification, judging, and planning.
+
+Why:
+
+- strong reasoning/tool use
+- large context
+- good fit for classification and orchestration
+- not the best default choice for every romantic or NSFW final reply
+
+Official sources:
+
+- https://docs.x.ai/docs/introduction
+- https://docs.x.ai/developers/models?cluster=us-east-1
+- https://docs.x.ai/docs/guides/reasoning
+
+#### GPT-5 mini
+
+Use for:
+
+- memory summaries
+- fact extraction
+- compact rewrites
+- cheap background jobs
+
+Official source:
+
+- https://developers.openai.com/api/docs/models
+
+#### GPT-5.4 or Claude Sonnet 4
+
+Use for:
+
+- creator workflows
+- rewriting persona cards
+- prompt cleanup
+- admin copilot workflows
+- evaluation and repair jobs
+
+Official sources:
+
+- https://developers.openai.com/api/docs/models
+- https://docs.anthropic.com/en/docs/about-claude/models/all-models
+
+## What Not To Do
+
+- Do not use Grok alone for every reply turn.
+- Do not use Claude as the main uncensored companion reply model.
+- Do not mix normal and NSFW routes in one generic explore page.
+- Do not keep all memory in the browser only.
+- Do not build the system around one huge system prompt.
+
+## Serving Layer
+
+### Preferred
+
+- `vLLM` for production OpenAI-compatible serving
+- `SGLang` as a strong alternative
+
+Why:
+
+- OpenAI-compatible APIs
+- tool calling support
+- structured outputs
+- prefix caching
+- better throughput than ad hoc local scripts
+
+Official sources:
+
+- https://docs.vllm.ai/en/latest/features/tool_calling/
+- https://docs.vllm.ai/en/stable/design/prefix_caching/
+- https://docs.sglang.ai/index.html
+- https://docs.sglang.ai/backend/function_calling.html
+
+### Example Topology
+
+- `AIRI app server`
+- `Hermes Agent service`
+- `vLLM` or `SGLang` serving `Hermes-4.3-36B`
+- `OpenAI API` for `GPT-5 mini` and optional `GPT-5.4`
+- `xAI API` for `Grok 4.20`
+- `Postgres + pgvector`
+- `Redis` for jobs/queues
+- object storage for gallery/media
+
+## Runtime Services In Hermes
+
+Implement these service boundaries inside Hermes Agent:
+
+- `scene_router`
+- `memory_service`
+- `context_assembler`
+- `reply_service`
+- `quality_judge`
+- `image_prompt_service`
+- `creator_copilot`
+- `ops_service`
+
+### scene_router
+
+Inputs:
+
+- current user message
+- route type
+- character metadata
+- recent turns
+
+Outputs:
+
+- scene type
+- intent
+- emotional intensity
+- whether NSFW policy applies
+- required memory slices
+- whether to call tools
+
+### memory_service
+
+Owns three layers:
+
+- recent turns
+- session summaries
+- long-term facts
+
+Long-term facts should include:
+
+- preferences
+- names
+- callbacks
+- relationship milestones
+- boundaries
+- content permissions
+
+### context_assembler
+
+Build the final inference input from:
+
+- system core
+- route policy
+- character persona
+- relationship state
+- scene state
+- selected memory
+- latest user message
+
+### reply_service
+
+Uses `Hermes-4.3-36B` to produce the final in-character reply.
+
+### quality_judge
+
+Uses `Grok 4.20` to score:
+
+- repetition
+- persona drift
+- scene drift
+- incoherence
+- escalation mistakes
+
+### image_prompt_service
+
+Uses `GPT-5.4` or `Grok 4.20` to turn user image requests into:
+
+- safe job parameters
+- character-aware prompts
+- pose/style tags
+- gallery metadata
+
+## AIRI To Hermes Contract
+
+### Request
+
+```json
+{
+  "request_id": "uuid",
+  "route": "normal",
+  "user": {
+    "id": "user_123",
+    "adult_verified": false,
+    "allow_sensitive_content": false,
+    "subscription_tier": "free"
+  },
+  "character": {
+    "id": "char_123",
+    "visibility": "public",
+    "relationship_mode": "companion",
+    "nsfw_enabled": false,
+    "nsfw_level": "none",
+    "persona_profile": {
+      "personality": "warm and direct",
+      "scenario": "long-term digital companion",
+      "speaking_style": "gentle",
+      "starter_messages": [],
+      "boundaries": []
+    }
+  },
+  "conversation": {
+    "id": "chat_123",
+    "recent_messages": [
+      {
+        "role": "user",
+        "content": "hey"
+      }
+    ]
+  },
+  "message": {
+    "role": "user",
+    "content": "hey"
+  }
+}
+```
+
+### Response
+
+```json
+{
+  "request_id": "uuid",
+  "route": "normal",
+  "reply": {
+    "role": "assistant",
+    "content": "Hi. I am here."
+  },
+  "runtime": {
+    "reply_model": "Hermes-4.3-36B",
+    "router_model": "grok-4.20",
+    "memory_model": "gpt-5-mini"
+  },
+  "memory_updates": {
+    "summary_append": "The user greeted the character.",
+    "facts_add": [],
+    "facts_remove": []
+  },
+  "judge": {
+    "score": 0.91,
+    "flags": []
+  }
+}
+```
+
+## NSFW Policy Split
+
+NSFW requests should be rejected before reply generation when:
+
+- user is not entitled
+- user is not age-gated
+- character is not flagged as NSFW
+- requested mode exceeds the character's configured level
+
+Suggested user-level flags:
+
+- `adult_verified`
+- `allow_sensitive_content`
+- `content_tier`
+
+Suggested character-level flags:
+
+- `nsfw_enabled`
+- `nsfw_level`
+- `relationship_mode`
+- `persona_profile.boundaries`
+
+## Memory Design
+
+### Short-Term
+
+- last 20 to 40 turns
+- kept in chat storage
+
+### Session Summary
+
+- one rolling summary per conversation
+- updated every few turns or after scene changes
+
+### Long-Term Facts
+
+Store small durable facts, not entire scenes.
+
+Examples:
+
+- user likes late-night chats
+- user prefers direct flirting
+- anniversary callback happened
+- user dislikes jealousy dynamics
+
+## Inference Flow
+
+1. AIRI sends a message event to Hermes.
+2. Hermes `scene_router` classifies intent and route.
+3. Hermes `memory_service` selects relevant memory.
+4. Hermes `context_assembler` builds the prompt package.
+5. Hermes `reply_service` calls `Hermes-4.3-36B`.
+6. Hermes `quality_judge` optionally scores the result.
+7. Hermes returns reply plus memory deltas to AIRI.
+8. AIRI stores the message and any memory updates.
+
+## Deployment Options
+
+### Best Quality
+
+- `Hermes-4.3-36B` on dedicated GPU serving
+- `Grok 4.20` for router/judge
+- `GPT-5 mini` for memory jobs
+- `GPT-5.4` for creator tooling
+
+### Lower Cost
+
+- `Hermes-4.3-36B` local/self-hosted
+- rules-based router for simple paths
+- `GPT-5 mini` only for memory
+- `Grok 4.20` only for premium judging or difficult cases
+
+### Closed-Model Heavy
+
+Possible, but not recommended for the uncensored core. It will usually produce higher refusal rates and weaker controllability for this product category.
+
+## Implementation Phases
+
+### Phase 1
+
+- finish AIRI normal vs NSFW route split
+- add user and character gating fields
+- define Hermes request/response schema
+
+### Phase 2
+
+- deploy `Hermes-4.3-36B`
+- add `scene_router`
+- add `memory_service`
+- wire AIRI chat requests into Hermes
+
+### Phase 3
+
+- add `quality_judge`
+- add gallery/image prompt service
+- add NSFW-specific generation flow
+
+### Phase 4
+
+- add creator copilot
+- add messaging gateways
+- add scheduled ops/reporting
+
+## Current Recommendation
+
+Use this stack unless a stronger self-hosted roleplay model clearly displaces Hermes 4.3:
+
+- replies: `Hermes-4.3-36B`
+- routing/judging: `Grok 4.20`
+- memory summaries: `GPT-5 mini`
+- creator tooling: `GPT-5.4`
+- orchestration runtime: Hermes Agent
+- consumer app: AIRI
diff --git a/docs/content/en/nsfw-companion-todo.md b/docs/content/en/nsfw-companion-todo.md
new file mode 100644
index 0000000000..34ac13f79e
--- /dev/null
+++ b/docs/content/en/nsfw-companion-todo.md
@@ -0,0 +1,82 @@
+# NSFW Companion Todo
+
+This is the implementation checklist for the AIRI + Hermes companion stack.
+
+## Immediate
+
+- [x] Split normal and NSFW surface routes in AIRI.
+- [x] Add shared Hermes request/response contracts.
+- [x] Add AIRI request builders for Hermes payloads.
+- [x] Add a real transport bridge from AIRI to Hermes.
+- [x] Add a Hermes `generate-reply` handler using the shared contract shape.
+
+## AIRI
+
+### Product Surface
+
+- [x] Finish `/nsfw` as a real management surface, not only discovery.
+- [ ] Add NSFW profile actions and access states.
+- [ ] Add `/nsfw/gallery`.
+- [ ] Add `/nsfw/generate`.
+- [ ] Add premium gating for NSFW actions.
+
+### Chat
+
+- [ ] Route `normal` and `nsfw` chat turns separately.
+- [x] Send Hermes request payloads from the active session.
+- [x] Persist Hermes memory deltas after each turn.
+- [ ] Add judge feedback handling for low-quality replies.
+
+### User and Character Data
+
+- [x] Add user-level flags:
+  - `adultVerified`
+  - `allowSensitiveContent`
+  - `contentTier`
+- [x] Add account settings UI and API route for user-level gating.
+- [x] Add UI for character-level NSFW controls.
+- [ ] Add stronger persona editing for:
+  - `personality`
+  - `scenario`
+  - `speakingStyle`
+  - `boundaries`
+  - `starterMessages`
+  - `memoryProfile`
+
+## Hermes Agent
+
+- [x] Add `scene_router`.
+- [x] Add `memory_service`.
+- [x] Add `context_assembler`.
+- [x] Add `reply_service`.
+- [ ] Add `quality_judge`.
+- [ ] Add `image_prompt_service`.
+- [ ] Add creator/admin copilot flows for AIRI characters.
+
+## Models
+
+- [ ] Deploy `Hermes-4.3-36B` behind `vLLM` or `SGLang`.
+- [ ] Configure `Grok 4.20` for routing and judging.
+- [ ] Configure `GPT-5 mini` for memory summaries.
+- [ ] Configure `GPT-5.4` or `Claude Sonnet 4` for creator/admin flows.
+
+## Memory
+
+- [ ] Keep recent turns server-side.
+- [ ] Add rolling session summaries.
+- [ ] Add long-term fact storage.
+- [ ] Add selective retrieval by scene and relationship state.
+
+## Media
+
+- [ ] Add image prompt generation.
+- [ ] Add image job queue.
+- [ ] Add gallery record storage.
+- [ ] Separate normal and NSFW media policy.
+
+## Verification
+
+- [ ] Add schema tests for Hermes contracts.
+- [ ] Add unit tests for Hermes request builders.
+- [ ] Add route tests for normal vs NSFW splits.
+- [ ] Run typecheck/build once dependencies are installed.
diff --git a/packages/server-schema/package.json b/packages/server-schema/package.json
index 108adc985e..9ad01ddd70 100644
--- a/packages/server-schema/package.json
+++ b/packages/server-schema/package.json
@@ -31,6 +31,9 @@
   "scripts": {
     "build": "tsdown"
   },
+  "dependencies": {
+    "valibot": "catalog:"
+  },
   "devDependencies": {
     "@proj-airi/unplugin-drizzle-orm-migrations": "catalog:"
   }
diff --git a/packages/server-schema/src/hermes-contract.ts b/packages/server-schema/src/hermes-contract.ts
new file mode 100644
index 0000000000..af9f02d34d
--- /dev/null
+++ b/packages/server-schema/src/hermes-contract.ts
@@ -0,0 +1,157 @@
+import type { InferOutput } from 'valibot'
+
+import {
+  array,
+  boolean,
+  literal,
+  nullable,
+  number,
+  object,
+  optional,
+  string,
+  union,
+} from 'valibot'
+
+export const HermesRouteSchema = union([
+  literal('normal'),
+  literal('nsfw'),
+])
+
+export const HermesSubscriptionTierSchema = union([
+  literal('free'),
+  literal('premium'),
+  literal('vip'),
+])
+
+export const HermesContentTierSchema = union([
+  literal('standard'),
+  literal('sensitive'),
+  literal('explicit'),
+])
+
+export const HermesCharacterVisibilitySchema = union([
+  literal('private'),
+  literal('public'),
+  literal('unlisted'),
+])
+
+export const HermesCharacterRelationshipModeSchema = union([
+  literal('companion'),
+  literal('romance'),
+  literal('roleplay'),
+])
+
+export const HermesCharacterNsfwLevelSchema = union([
+  literal('none'),
+  literal('suggestive'),
+  literal('explicit'),
+])
+
+export const HermesCharacterMemoryProfileSchema = union([
+  literal('light'),
+  literal('standard'),
+  literal('deep'),
+])
+
+export const HermesChatMessageRoleSchema = union([
+  literal('system'),
+  literal('user'),
+  literal('assistant'),
+  literal('tool'),
+  literal('error'),
+])
+
+export const HermesSceneTypeSchema = union([
+  literal('general'),
+  literal('romance'),
+  literal('roleplay'),
+  literal('nsfw'),
+  literal('support'),
+])
+
+export const HermesUserContextSchema = object({
+  id: string(),
+  adultVerified: boolean(),
+  allowSensitiveContent: boolean(),
+  subscriptionTier: HermesSubscriptionTierSchema,
+  contentTier: HermesContentTierSchema,
+})
+
+export const HermesPersonaProfileSchema = object({
+  personality: optional(string()),
+  scenario: optional(string()),
+  speakingStyle: optional(string()),
+  starterMessages: optional(array(string())),
+  boundaries: optional(array(string())),
+  memoryProfile: optional(HermesCharacterMemoryProfileSchema),
+})
+
+export const HermesCharacterContextSchema = object({
+  id: string(),
+  visibility: HermesCharacterVisibilitySchema,
+  relationshipMode: HermesCharacterRelationshipModeSchema,
+  nsfwEnabled: boolean(),
+  nsfwLevel: HermesCharacterNsfwLevelSchema,
+  personaProfile: HermesPersonaProfileSchema,
+})
+
+export const HermesConversationMessageSchema = object({
+  id: optional(string()),
+  role: HermesChatMessageRoleSchema,
+  content: string(),
+})
+
+export const HermesConversationContextSchema = object({
+  id: string(),
+  recentMessages: array(HermesConversationMessageSchema),
+})
+
+export const HermesReplyRequestSchema = object({
+  requestId: string(),
+  route: HermesRouteSchema,
+  user: HermesUserContextSchema,
+  character: HermesCharacterContextSchema,
+  conversation: HermesConversationContextSchema,
+  message: HermesConversationMessageSchema,
+})
+
+export const HermesRuntimeSelectionSchema = object({
+  replyModel: string(),
+  routerModel: string(),
+  memoryModel: string(),
+})
+
+export const HermesMemoryUpdatesSchema = object({
+  summaryAppend: optional(string()),
+  factsAdd: array(string()),
+  factsRemove: array(string()),
+})
+
+export const HermesJudgeResultSchema = object({
+  score: nullable(number()),
+  flags: array(string()),
+})
+
+export const HermesReplyResponseSchema = object({
+  requestId: string(),
+  route: HermesRouteSchema,
+  reply: HermesConversationMessageSchema,
+  runtime: HermesRuntimeSelectionSchema,
+  memoryUpdates: HermesMemoryUpdatesSchema,
+  judge: HermesJudgeResultSchema,
+  sceneType: optional(HermesSceneTypeSchema),
+})
+
+export type HermesRoute = InferOutput<typeof HermesRouteSchema>
+export type HermesSubscriptionTier = InferOutput<typeof HermesSubscriptionTierSchema>
+export type HermesContentTier = InferOutput<typeof HermesContentTierSchema>
+export type HermesUserContext = InferOutput<typeof HermesUserContextSchema>
+export type HermesPersonaProfile = InferOutput<typeof HermesPersonaProfileSchema>
+export type HermesCharacterContext = InferOutput<typeof HermesCharacterContextSchema>
+export type HermesConversationMessage = InferOutput<typeof HermesConversationMessageSchema>
+export type HermesConversationContext = InferOutput<typeof HermesConversationContextSchema>
+export type HermesReplyRequest = InferOutput<typeof HermesReplyRequestSchema>
+export type HermesRuntimeSelection = InferOutput<typeof HermesRuntimeSelectionSchema>
+export type HermesMemoryUpdates = InferOutput<typeof HermesMemoryUpdatesSchema>
+export type HermesJudgeResult = InferOutput<typeof HermesJudgeResultSchema>
+export type HermesReplyResponse = InferOutput<typeof HermesReplyResponseSchema>
diff --git a/packages/server-schema/src/index.ts b/packages/server-schema/src/index.ts
index 5a23a8303d..0f25e08680 100644
--- a/packages/server-schema/src/index.ts
+++ b/packages/server-schema/src/index.ts
@@ -1 +1,2 @@
 export { default as migrations } from 'virtual:drizzle-migrations.sql'
+export * from './hermes-contract'
diff --git a/packages/server-sdk-shared/src/index.ts b/packages/server-sdk-shared/src/index.ts
index ad14cd3e86..312c2d3f44 100644
--- a/packages/server-sdk-shared/src/index.ts
+++ b/packages/server-sdk-shared/src/index.ts
@@ -1,5 +1,70 @@
 import { defineInvokeEventa, defineOutboundEventa } from '@moeru/eventa'
 
+export interface HermesUserContext {
+  id: string
+  adultVerified: boolean
+  allowSensitiveContent: boolean
+  subscriptionTier: 'free' | 'premium' | 'vip'
+  contentTier: 'standard' | 'sensitive' | 'explicit'
+}
+
+export interface HermesPersonaProfile {
+  personality?: string
+  scenario?: string
+  speakingStyle?: string
+  starterMessages?: string[]
+  boundaries?: string[]
+  memoryProfile?: 'light' | 'standard' | 'deep'
+}
+
+export interface HermesCharacterContext {
+  id: string
+  visibility: 'private' | 'public' | 'unlisted'
+  relationshipMode: 'companion' | 'romance' | 'roleplay'
+  nsfwEnabled: boolean
+  nsfwLevel: 'none' | 'suggestive' | 'explicit'
+  personaProfile: HermesPersonaProfile
+}
+
+export interface HermesConversationMessage {
+  id?: string
+  role: 'system' | 'user' | 'assistant' | 'tool' | 'error'
+  content: string
+}
+
+export interface HermesReplyRequest {
+  requestId: string
+  route: 'normal' | 'nsfw'
+  user: HermesUserContext
+  character: HermesCharacterContext
+  conversation: {
+    id: string
+    recentMessages: HermesConversationMessage[]
+  }
+  message: HermesConversationMessage
+}
+
+export interface HermesReplyResponse {
+  requestId: string
+  route: 'normal' | 'nsfw'
+  reply: HermesConversationMessage
+  runtime: {
+    replyModel: string
+    routerModel: string
+    memoryModel: string
+  }
+  memoryUpdates: {
+    summaryAppend?: string
+    factsAdd: string[]
+    factsRemove: string[]
+  }
+  judge: {
+    score: number | null
+    flags: string[]
+  }
+  sceneType?: 'general' | 'romance' | 'roleplay' | 'nsfw' | 'support'
+}
+
 export interface WireMessage {
   id: string
   chatId: string
@@ -43,3 +108,4 @@ export interface NewMessagesPayload {
 export const sendMessages = defineInvokeEventa<SendMessagesResponse, SendMessagesRequest>('chat:send-messages')
 export const pullMessages = defineInvokeEventa<PullMessagesResponse, PullMessagesRequest>('chat:pull-messages')
 export const newMessages = defineOutboundEventa<NewMessagesPayload>('chat:new-messages')
+export const generateHermesReply = defineInvokeEventa<HermesReplyResponse, HermesReplyRequest>('hermes:generate-reply')
diff --git a/packages/stage-pages/src/pages/nsfw/[id].vue b/packages/stage-pages/src/pages/nsfw/[id].vue
new file mode 100644
index 0000000000..6b1673c7b0
--- /dev/null
+++ b/packages/stage-pages/src/pages/nsfw/[id].vue
@@ -0,0 +1,235 @@
+<script setup lang="ts">
+import { useAuthStore } from '@proj-airi/stage-ui/stores/auth'
+import { useCharacterStore } from '@proj-airi/stage-ui/stores/characters'
+import { Button } from '@proj-airi/ui'
+import { computed, onMounted, ref } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+
+const route = useRoute()
+const router = useRouter()
+const characterStore = useCharacterStore()
+const authStore = useAuthStore()
+
+const loading = ref(true)
+const failed = ref(false)
+
+const characterId = computed(() => String(route.params.id || ''))
+
+onMounted(async () => {
+  loading.value = true
+  failed.value = false
+  try {
+    await characterStore.fetchById(characterId.value)
+  }
+  catch {
+    failed.value = true
+  }
+  finally {
+    loading.value = false
+  }
+})
+
+const character = computed(() => characterStore.getCharacter(characterId.value))
+const i18n = computed(() => character.value?.i18n?.[0])
+const starterMessages = computed(() => character.value?.personaProfile?.starterMessages || [])
+const boundaries = computed(() => character.value?.personaProfile?.boundaries || [])
+const liked = computed(() => !!character.value?.likes?.some(item => item.userId === authStore.user?.id))
+const bookmarked = computed(() => !!character.value?.bookmarks?.some(item => item.userId === authStore.user?.id))
+const accessBadges = computed(() => {
+  if (!character.value)
+    return []
+
+  return [
+    character.value.nsfwLevel,
+    character.value.relationshipMode,
+    character.value.visibility,
+  ].filter(Boolean)
+})
+const accessDenied = computed(() => !authStore.canAccessNsfw)
+
+async function enterStage() {
+  if (!character.value)
+    return
+
+  await characterStore.activateCharacter(character.value.id)
+  router.push('/')
+}
+</script>
+
+<template>
+  <div class="min-h-screen px-4 py-8 md:px-8">
+    <div mx-auto max-w-6xl>
+      <div class="mb-6 flex items-center justify-between gap-4">
+        <Button variant="ghost" @click="router.push('/nsfw')">
+          Back to NSFW Explore
+        </Button>
+        <div v-if="character" class="flex items-center gap-2">
+          <Button variant="ghost" @click="characterStore.bookmark(character.id)">
+            {{ bookmarked ? 'Bookmarked' : 'Bookmark' }}
+          </Button>
+          <Button variant="ghost" @click="characterStore.like(character.id)">
+            {{ liked ? 'Liked' : 'Like' }}
+          </Button>
+        </div>
+      </div>
+
+      <div v-if="loading" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        Loading NSFW profile...
+      </div>
+
+      <div v-else-if="accessDenied" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        NSFW access is disabled for this account.
+      </div>
+
+      <div v-else-if="failed || !character || !i18n || !character.nsfwEnabled || character.nsfwLevel === 'none'" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        NSFW character not found.
+      </div>
+
+      <div v-else class="grid gap-6 lg:grid-cols-[1.15fr,0.85fr]">
+        <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-rose-950 to-black text-white shadow-sm">
+          <img
+            :src="character.coverUrl"
+            :alt="i18n.name"
+            class="absolute inset-0 h-full w-full object-cover opacity-40"
+          >
+          <div class="absolute inset-0 bg-linear-to-t from-black via-black/50 to-transparent" />
+          <div class="relative z-1 flex min-h-[34rem] flex-col justify-end gap-5 p-6 md:p-8">
+            <div class="flex flex-wrap gap-2">
+              <span
+                v-for="badge in accessBadges"
+                :key="badge"
+                class="rounded-full bg-white/12 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur"
+              >
+                {{ badge }}
+              </span>
+            </div>
+
+            <div class="max-w-2xl">
+              <h1 class="text-4xl font-semibold md:text-5xl">
+                {{ i18n.name }}
+              </h1>
+              <p class="mt-3 max-w-xl text-sm leading-6 text-white/80 md:text-base">
+                {{ character.personaProfile?.personality || i18n.description }}
+              </p>
+            </div>
+
+            <div class="grid gap-3 sm:grid-cols-3">
+              <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
+                <div class="text-[11px] uppercase tracking-[0.16em] text-white/60">
+                  Surface
+                </div>
+                <div class="mt-1 text-sm font-medium">
+                  NSFW
+                </div>
+              </div>
+              <div v-if="character.personaProfile?.speakingStyle" class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
+                <div class="text-[11px] uppercase tracking-[0.16em] text-white/60">
+                  Speaking Style
+                </div>
+                <div class="mt-1 text-sm font-medium">
+                  {{ character.personaProfile?.speakingStyle }}
+                </div>
+              </div>
+              <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
+                <div class="text-[11px] uppercase tracking-[0.16em] text-white/60">
+                  Dynamic
+                </div>
+                <div class="mt-1 text-sm font-medium">
+                  {{ character.relationshipMode }}
+                </div>
+              </div>
+            </div>
+
+            <div class="flex flex-wrap gap-3">
+              <Button @click="enterStage">
+                Enter Stage
+              </Button>
+              <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/settings/characters')">
+                Manage Character
+              </Button>
+            </div>
+          </div>
+        </section>
+
+        <section class="flex flex-col gap-6">
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Scenario
+            </h2>
+            <p class="mt-3 text-sm leading-6 text-neutral-600 dark:text-neutral-300">
+              {{ character.personaProfile?.scenario || i18n.description }}
+            </p>
+          </div>
+
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Starter Messages
+            </h2>
+            <div v-if="starterMessages.length" class="mt-3 flex flex-col gap-2">
+              <div
+                v-for="message in starterMessages"
+                :key="message"
+                class="rounded-2xl bg-neutral-50 px-4 py-3 text-sm text-neutral-700 dark:bg-neutral-800 dark:text-neutral-200"
+              >
+                {{ message }}
+              </div>
+            </div>
+            <p v-else class="mt-3 text-sm text-neutral-500 dark:text-neutral-400">
+              No starter messages configured.
+            </p>
+          </div>
+
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Boundaries
+            </h2>
+            <div v-if="boundaries.length" class="mt-3 flex flex-wrap gap-2">
+              <span
+                v-for="boundary in boundaries"
+                :key="boundary"
+                class="rounded-full bg-amber-100 px-3 py-1 text-xs font-medium text-amber-700 dark:bg-amber-500/15 dark:text-amber-300"
+              >
+                {{ boundary }}
+              </span>
+            </div>
+            <p v-else class="mt-3 text-sm text-neutral-500 dark:text-neutral-400">
+              No boundaries configured.
+            </p>
+          </div>
+
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Engagement
+            </h2>
+            <div class="mt-4 grid grid-cols-3 gap-3">
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 text-center dark:bg-neutral-800">
+                <div class="text-xl font-semibold">
+                  {{ character.likesCount }}
+                </div>
+                <div class="text-xs uppercase tracking-wide text-neutral-500 dark:text-neutral-400">
+                  Likes
+                </div>
+              </div>
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 text-center dark:bg-neutral-800">
+                <div class="text-xl font-semibold">
+                  {{ character.bookmarksCount }}
+                </div>
+                <div class="text-xs uppercase tracking-wide text-neutral-500 dark:text-neutral-400">
+                  Saves
+                </div>
+              </div>
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 text-center dark:bg-neutral-800">
+                <div class="text-xl font-semibold">
+                  {{ character.interactionsCount }}
+                </div>
+                <div class="text-xs uppercase tracking-wide text-neutral-500 dark:text-neutral-400">
+                  Chats
+                </div>
+              </div>
+            </div>
+          </div>
+        </section>
+      </div>
+    </div>
+  </div>
+</template>
diff --git a/packages/stage-pages/src/pages/nsfw/index.vue b/packages/stage-pages/src/pages/nsfw/index.vue
index ebcba2a38e..e804961879 100644
--- a/packages/stage-pages/src/pages/nsfw/index.vue
+++ b/packages/stage-pages/src/pages/nsfw/index.vue
@@ -1,51 +1,643 @@
+<script setup lang="ts">
+import { useAuthStore } from '@proj-airi/stage-ui/stores/auth'
+import { useCharacterStore } from '@proj-airi/stage-ui/stores/characters'
+import { Button } from '@proj-airi/ui'
+import { computed, onMounted, reactive, ref, watch } from 'vue'
+import { useRouter } from 'vue-router'
+
+const characterStore = useCharacterStore()
+const authStore = useAuthStore()
+const router = useRouter()
+
+const activeLevel = ref<'all' | 'suggestive' | 'explicit'>('all')
+const selectedCharacterId = ref('')
+const savingCharacter = ref(false)
+const saveError = ref('')
+const saveSuccess = ref(false)
+
+const editor = reactive({
+  nsfwEnabled: false,
+  nsfwLevel: 'suggestive' as 'none' | 'suggestive' | 'explicit',
+  relationshipMode: 'companion' as 'companion' | 'romance' | 'roleplay',
+  visibility: 'private' as 'private' | 'public' | 'unlisted',
+  boundaries: '',
+})
+
+function formatCount(value: number | string) {
+  const num = typeof value === 'string' ? Number.parseInt(value) : value
+  if (Number.isNaN(num))
+    return '0'
+
+  const units = [
+    { suffix: 'Q', value: 1_000_000_000_000_000 },
+    { suffix: 'T', value: 1_000_000_000_000 },
+    { suffix: 'B', value: 1_000_000_000 },
+    { suffix: 'M', value: 1_000_000 },
+    { suffix: 'K', value: 1_000 },
+  ]
+
+  for (const unit of units) {
+    if (num >= unit.value) {
+      const scaled = num / unit.value
+      const digits = scaled >= 10 ? 0 : 1
+      return `${scaled.toFixed(digits)}${unit.suffix}`
+    }
+  }
+
+  return num.toString()
+}
+
+onMounted(() => {
+  characterStore.fetchList(true)
+})
+
+async function openCharacter(id: string) {
+  await characterStore.activateCharacter(id)
+  router.push(`/nsfw/${id}`)
+}
+
+const characters = computed(() => Array.from(characterStore.characters.values())
+  .filter((char) => {
+    if (!char.nsfwEnabled || char.nsfwLevel === 'none')
+      return false
+    if (activeLevel.value === 'all')
+      return true
+    return char.nsfwLevel === activeLevel.value
+  })
+  .sort((a, b) => Number(b.interactionsCount || 0) - Number(a.interactionsCount || 0))
+  .map((char) => {
+    const i18n = char.i18n?.[0] || { name: char.characterId, tagline: '', description: '' }
+
+    return {
+      id: char.id,
+      name: i18n.name,
+      tagline: i18n.tagline || i18n.description,
+      avatarUrl: char.avatarUrl,
+      characterAvatarUrl: char.characterAvatarUrl,
+      coverUrl: char.coverUrl,
+      coverBackgroundUrl: char.coverBackgroundUrl,
+      interactions: char.interactionsCount,
+      likes: char.likesCount,
+      bookmarks: char.bookmarksCount,
+      visibility: char.visibility,
+      nsfwLevel: char.nsfwLevel,
+      relationshipMode: char.relationshipMode,
+      personality: char.personaProfile?.personality,
+      scenario: char.personaProfile?.scenario,
+      liked: char.likes?.some(l => l.userId === authStore.user?.id),
+      bookmarked: char.bookmarks?.some(b => b.userId === authStore.user?.id),
+      priceCredit: char.priceCredit,
+    }
+  }))
+
+const stats = computed(() => {
+  const list = characters.value
+  return {
+    total: list.length,
+    explicit: list.filter(item => item.nsfwLevel === 'explicit').length,
+    suggestive: list.filter(item => item.nsfwLevel === 'suggestive').length,
+    active: list.filter(item => item.id === characterStore.activeCharacterId).length,
+  }
+})
+
+const featuredCharacter = computed(() => characters.value[0] || null)
+const latestCharacters = computed(() => characters.value.slice(0, 4))
+const accessDenied = computed(() => !authStore.canAccessNsfw)
+const selectedCharacter = computed(() => selectedCharacterId.value ? characterStore.getCharacter(selectedCharacterId.value) : null)
+
+const levels = [
+  { id: 'all', label: 'All Levels' },
+  { id: 'suggestive', label: 'Suggestive' },
+  { id: 'explicit', label: 'Explicit' },
+] as const
+
+watch(selectedCharacter, (character) => {
+  if (!character)
+    return
+
+  editor.nsfwEnabled = character.nsfwEnabled
+  editor.nsfwLevel = character.nsfwLevel
+  editor.relationshipMode = character.relationshipMode
+  editor.visibility = character.visibility
+  editor.boundaries = character.personaProfile?.boundaries?.join('\n') || ''
+  saveError.value = ''
+  saveSuccess.value = false
+}, { immediate: true })
+
+onMounted(() => {
+  if (!selectedCharacterId.value) {
+    const first = Array.from(characterStore.characters.values()).find(char => char.nsfwEnabled && char.nsfwLevel !== 'none')
+    if (first)
+      selectedCharacterId.value = first.id
+  }
+})
+
+async function saveSelectedCharacter() {
+  if (!selectedCharacter.value)
+    return
+
+  savingCharacter.value = true
+  saveError.value = ''
+  saveSuccess.value = false
+
+  try {
+    await characterStore.update(selectedCharacter.value.id, {
+      nsfwEnabled: editor.nsfwEnabled,
+      nsfwLevel: editor.nsfwLevel,
+      relationshipMode: editor.relationshipMode,
+      visibility: editor.visibility,
+      personaProfile: {
+        ...(selectedCharacter.value.personaProfile ?? {}),
+        boundaries: editor.boundaries
+          .split('\n')
+          .map(item => item.trim())
+          .filter(Boolean),
+      },
+    })
+    saveSuccess.value = true
+  }
+  catch (err) {
+    saveError.value = err instanceof Error ? err.message : 'Failed to save NSFW settings'
+  }
+  finally {
+    savingCharacter.value = false
+  }
+}
+</script>
+
 <template>
-  <div class="min-h-screen px-4 py-10 md:px-8">
-    <div mx-auto max-w-5xl class="space-y-6">
-      <section class="rounded-[2rem] bg-linear-to-br from-neutral-950 via-neutral-900 to-rose-950 px-6 py-8 text-white shadow-sm">
-        <div class="max-w-3xl">
+  <div class="min-h-screen px-4 py-8 md:px-8">
+    <div mx-auto max-w-7xl class="space-y-8">
+      <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-rose-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
+        <div class="absolute right--12 top--14 h-60 w-60 rounded-full bg-rose-400/15 blur-3xl" />
+        <div class="absolute bottom--12 left-8 h-48 w-48 rounded-full bg-orange-300/10 blur-3xl" />
+        <div class="relative z-1 max-w-3xl">
           <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.16em] backdrop-blur">
-            Separate NSFW Workspace
+            NSFW Explore
           </div>
-          <h1 class="text-4xl font-semibold md:text-5xl">
-            Keep NSFW separate from the normal product flow
+          <h1 class="max-w-2xl text-4xl font-semibold leading-tight md:text-5xl">
+            Explicit companions, isolated from the normal catalog
           </h1>
           <p class="mt-4 max-w-2xl text-sm text-white/75 leading-6 md:text-base">
-            This area is reserved for NSFW-specific routes, character controls, prompts, gallery behavior, and moderation policy so your regular companion UX stays clean.
+            Browse, rank, and launch adult characters here while your main `v2` surface stays clean. This page only pulls characters already marked for NSFW use.
           </p>
+          <div class="mt-6 flex flex-wrap gap-2">
+            <button
+              v-for="level in levels"
+              :key="level.id"
+              class="rounded-full px-4 py-2 text-sm font-medium transition-all"
+              :class="activeLevel === level.id
+                ? 'bg-white text-neutral-950'
+                : 'bg-white/10 text-white ring-1 ring-white/15 hover:bg-white/15'"
+              @click="activeLevel = level.id"
+            >
+              {{ level.label }}
+            </button>
+          </div>
         </div>
       </section>
 
-      <section class="grid gap-4 md:grid-cols-3">
-        <div class="rounded-[1.5rem] bg-white p-5 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+      <section v-if="accessDenied" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        <h2 class="text-2xl font-semibold">
+          NSFW access is disabled
+        </h2>
+        <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+          This account needs adult verification, sensitive content enabled, and a non-standard content tier before the NSFW catalog is available.
+        </p>
+        <div class="mt-6 flex justify-center gap-3">
+          <Button variant="ghost" @click="router.push('/v2')">
+            Back to Normal Explore
+          </Button>
+          <Button @click="router.push('/settings')">
+            Open Settings
+          </Button>
+        </div>
+      </section>
+
+      <template v-else>
+      <section class="grid gap-4 lg:grid-cols-[1.3fr,0.7fr]">
+        <div class="rounded-[1.75rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+          <div class="flex items-center justify-between gap-4">
+            <div>
+              <h2 class="text-lg font-semibold">
+                NSFW Inventory
+              </h2>
+              <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+                Only characters with `nsfwEnabled` and a non-`none` level show up here.
+              </p>
+            </div>
+            <Button variant="ghost" @click="router.push('/settings/characters')">
+              Manage Characters
+            </Button>
+          </div>
+          <div class="mt-5 grid gap-3 sm:grid-cols-4">
+            <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+              <div class="text-[11px] uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                Total
+              </div>
+              <div class="mt-1 text-2xl font-semibold">
+                {{ stats.total }}
+              </div>
+            </div>
+            <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+              <div class="text-[11px] uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                Explicit
+              </div>
+              <div class="mt-1 text-2xl font-semibold">
+                {{ stats.explicit }}
+              </div>
+            </div>
+            <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+              <div class="text-[11px] uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                Suggestive
+              </div>
+              <div class="mt-1 text-2xl font-semibold">
+                {{ stats.suggestive }}
+              </div>
+            </div>
+            <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+              <div class="text-[11px] uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                Active
+              </div>
+              <div class="mt-1 text-2xl font-semibold">
+                {{ stats.active }}
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <div class="rounded-[1.75rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
           <h2 class="text-lg font-semibold">
-            Character Access
+            Route Split
           </h2>
           <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
-            Per-character NSFW enablement, explicitness level, and separate onboarding or gating.
+            Normal `v2` discovery stays clean. Adult discovery, explicit persona tags, and future gallery generation stay under `/nsfw`.
           </p>
+          <div class="mt-5 flex flex-wrap gap-3">
+            <Button @click="router.push('/v2')">
+              Open Normal Explore
+            </Button>
+            <Button variant="ghost" @click="router.push('/settings/characters')">
+              Edit Character Flags
+            </Button>
+          </div>
         </div>
-        <div class="rounded-[1.5rem] bg-white p-5 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+      </section>
+
+      <section class="grid gap-4 lg:grid-cols-[0.9fr,1.1fr]">
+        <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+          <div class="flex items-center justify-between gap-3">
+            <h2 class="text-lg font-semibold">
+              Character Controls
+            </h2>
+            <span v-if="selectedCharacter" class="text-xs text-neutral-500 dark:text-neutral-400">
+              {{ selectedCharacter.i18n?.[0]?.name || selectedCharacter.characterId }}
+            </span>
+          </div>
+
+          <div class="mt-4 space-y-3">
+            <button
+              v-for="character in characters"
+              :key="character.id"
+              type="button"
+              class="flex w-full items-center justify-between rounded-2xl px-4 py-3 text-left transition"
+              :class="selectedCharacterId === character.id
+                ? 'bg-neutral-950 text-white dark:bg-white dark:text-neutral-950'
+                : 'bg-neutral-50 hover:bg-neutral-100 dark:bg-neutral-800 dark:hover:bg-neutral-700'"
+              @click="selectedCharacterId = character.id"
+            >
+              <div class="min-w-0">
+                <div class="line-clamp-1 text-sm font-medium">
+                  {{ character.name }}
+                </div>
+                <div class="mt-1 line-clamp-1 text-xs opacity-75">
+                  {{ character.nsfwLevel }} · {{ character.relationshipMode }}
+                </div>
+              </div>
+              <div class="ml-4 shrink-0 text-xs opacity-75">
+                {{ character.visibility }}
+              </div>
+            </button>
+          </div>
+        </div>
+
+        <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
           <h2 class="text-lg font-semibold">
-            Prompt Layer
+            NSFW Settings
           </h2>
-          <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
-            Separate routing, style controls, and policy logic without mixing it into normal companion prompts.
-          </p>
+
+          <div v-if="selectedCharacter" class="mt-4 space-y-4">
+            <label class="flex items-center justify-between gap-4 rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+              <div>
+                <div class="text-sm font-medium">
+                  NSFW Enabled
+                </div>
+                <div class="mt-1 text-xs text-neutral-500 dark:text-neutral-400">
+                  Controls whether this character can appear in `/nsfw`.
+                </div>
+              </div>
+              <input v-model="editor.nsfwEnabled" type="checkbox" class="h-4 w-4">
+            </label>
+
+            <div class="grid gap-4 sm:grid-cols-2">
+              <div class="flex flex-col gap-1.5">
+                <label class="text-sm font-medium">NSFW Level</label>
+                <select v-model="editor.nsfwLevel" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                  <option value="none">
+                    None
+                  </option>
+                  <option value="suggestive">
+                    Suggestive
+                  </option>
+                  <option value="explicit">
+                    Explicit
+                  </option>
+                </select>
+              </div>
+
+              <div class="flex flex-col gap-1.5">
+                <label class="text-sm font-medium">Relationship Mode</label>
+                <select v-model="editor.relationshipMode" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                  <option value="companion">
+                    Companion
+                  </option>
+                  <option value="romance">
+                    Romance
+                  </option>
+                  <option value="roleplay">
+                    Roleplay
+                  </option>
+                </select>
+              </div>
+            </div>
+
+            <div class="flex flex-col gap-1.5">
+              <label class="text-sm font-medium">Visibility</label>
+              <select v-model="editor.visibility" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                <option value="private">
+                  Private
+                </option>
+                <option value="unlisted">
+                  Unlisted
+                </option>
+                <option value="public">
+                  Public
+                </option>
+              </select>
+            </div>
+
+            <div class="flex flex-col gap-1.5">
+              <label class="text-sm font-medium">Boundaries</label>
+              <textarea
+                v-model="editor.boundaries"
+                rows="5"
+                class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800"
+                placeholder="One per line"
+              />
+            </div>
+
+            <div class="flex items-center gap-3">
+              <Button :disabled="savingCharacter" @click="saveSelectedCharacter">
+                {{ savingCharacter ? 'Saving...' : 'Save NSFW Settings' }}
+              </Button>
+              <span v-if="saveSuccess" class="text-sm text-emerald-600 dark:text-emerald-400">
+                Saved
+              </span>
+              <span v-if="saveError" class="text-sm text-rose-600 dark:text-rose-400">
+                {{ saveError }}
+              </span>
+            </div>
+          </div>
+
+          <div v-else class="mt-4 text-sm text-neutral-500 dark:text-neutral-400">
+            Select a character to edit its NSFW settings.
+          </div>
+        </div>
+      </section>
+
+      <section v-if="featuredCharacter" class="grid gap-4 lg:grid-cols-[1.1fr,0.9fr]">
+        <div class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-neutral-900 to-rose-950 p-6 text-white shadow-sm">
+          <img
+            v-if="featuredCharacter.coverUrl"
+            :src="featuredCharacter.coverUrl"
+            :alt="featuredCharacter.name"
+            class="absolute inset-0 h-full w-full object-cover opacity-25"
+          >
+          <div class="absolute inset-0 bg-linear-to-r from-black via-black/60 to-transparent" />
+          <div class="relative z-1 max-w-xl">
+            <div class="inline-flex rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur">
+              Top By Chats
+            </div>
+            <h2 class="mt-4 text-3xl font-semibold">
+              {{ featuredCharacter.name }}
+            </h2>
+            <p class="mt-3 text-sm leading-6 text-white/75">
+              {{ featuredCharacter.personality || featuredCharacter.scenario || featuredCharacter.tagline }}
+            </p>
+            <div class="mt-4 flex flex-wrap gap-2">
+              <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur">
+                {{ featuredCharacter.nsfwLevel }}
+              </span>
+              <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur">
+                {{ featuredCharacter.relationshipMode }}
+              </span>
+              <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur">
+                {{ formatCount(featuredCharacter.interactions) }} chats
+              </span>
+            </div>
+            <div class="mt-6 flex flex-wrap gap-3">
+              <Button @click="openCharacter(featuredCharacter.id)">
+                Open Profile
+              </Button>
+              <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="characterStore.activateCharacter(featuredCharacter.id)">
+                Activate Only
+              </Button>
+            </div>
+          </div>
         </div>
-        <div class="rounded-[1.5rem] bg-white p-5 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+
+        <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
           <h2 class="text-lg font-semibold">
-            Gallery & Media
+            Recent NSFW Picks
           </h2>
-          <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
-            Reserved for image generation, galleries, and other NSFW-specific media workflows.
-          </p>
+          <div class="mt-4 space-y-3">
+            <button
+              v-for="character in latestCharacters"
+              :key="character.id"
+              type="button"
+              class="flex w-full items-center justify-between rounded-2xl bg-neutral-50 px-4 py-3 text-left transition hover:bg-neutral-100 dark:bg-neutral-800 dark:hover:bg-neutral-700"
+              @click="openCharacter(character.id)"
+            >
+              <div class="min-w-0">
+                <div class="line-clamp-1 text-sm font-medium">
+                  {{ character.name }}
+                </div>
+                <div class="mt-1 line-clamp-1 text-xs text-neutral-500 dark:text-neutral-400">
+                  {{ character.personality || character.tagline }}
+                </div>
+              </div>
+              <div class="ml-4 flex shrink-0 items-center gap-2">
+                <span class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide text-rose-700 dark:bg-rose-500/15 dark:text-rose-300">
+                  {{ character.nsfwLevel }}
+                </span>
+                <div class="i-solar:arrow-right-linear text-base text-neutral-400" />
+              </div>
+            </button>
+          </div>
         </div>
       </section>
+
+      <section
+        v-if="!characters.length"
+        class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800"
+      >
+        <h2 class="text-2xl font-semibold">
+          No NSFW characters available
+        </h2>
+        <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+          Turn on NSFW for a character and assign a level before it appears here.
+        </p>
+        <div class="mt-6 flex justify-center gap-3">
+          <Button @click="router.push('/settings/characters')">
+            Open Character Settings
+          </Button>
+          <Button variant="ghost" @click="router.push('/v2')">
+            Back to Normal Explore
+          </Button>
+        </div>
+      </section>
+
+      <section v-else class="grid gap-6 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5">
+        <article
+          v-for="character in characters"
+          :key="character.id"
+          class="group relative aspect-[12/19] overflow-hidden rounded-3xl shadow-sm"
+        >
+          <div class="relative h-70% overflow-hidden rounded-2xl">
+            <img
+              v-if="character.coverBackgroundUrl"
+              :src="character.coverBackgroundUrl"
+              :alt="character.name"
+              class="absolute inset-0 z-5 h-full w-full object-cover"
+            >
+            <div v-else class="absolute inset-0 z-5 h-full w-full bg-neutral-950" />
+            <img
+              v-if="character.coverUrl"
+              :src="character.coverUrl"
+              :alt="character.name"
+              class="absolute left-0 top-0 z-5 h-full w-full object-cover transition duration-300 ease-in-out"
+            >
+          </div>
+
+          <div class="relative z-7 h-30% overflow-hidden">
+            <div class="relative z-1 h-full">
+              <div class="relative flex h-full flex-col justify-between gap-2 px-3 pb-3 pt-2">
+                <div class="flex items-center justify-between gap-3">
+                  <div class="flex items-center gap-2">
+                    <img
+                      v-if="character.characterAvatarUrl"
+                      :src="character.characterAvatarUrl"
+                      :alt="character.name"
+                      class="h-7 w-7 rounded-full object-cover"
+                    >
+                    <div v-else class="h-7 w-7 rounded-full bg-neutral-300 dark:bg-neutral-700" />
+                    <div class="line-clamp-1 text-lg font-semibold">
+                      {{ character.name }}
+                    </div>
+                  </div>
+                  <div class="flex items-center gap-1 text-xs">
+                    <div i-tabler:coins />
+                    <div>{{ formatCount(character.priceCredit) }}</div>
+                  </div>
+                </div>
+
+                <div class="flex flex-wrap gap-1.5">
+                  <span class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide text-rose-700 dark:bg-rose-500/15 dark:text-rose-300">
+                    {{ character.nsfwLevel }}
+                  </span>
+                  <span class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide text-neutral-600 dark:bg-neutral-800 dark:text-neutral-300">
+                    {{ character.relationshipMode }}
+                  </span>
+                  <span class="rounded-full bg-amber-100 px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide text-amber-700 dark:bg-amber-500/15 dark:text-amber-300">
+                    {{ character.visibility }}
+                  </span>
+                </div>
+
+                <div class="max-h-[3rem] flex-1 overflow-hidden text-xs text-neutral-500 line-clamp-3">
+                  {{ character.personality || character.scenario || character.tagline }}
+                </div>
+
+                <div class="grid grid-cols-3 items-center">
+                  <div class="flex items-center justify-start">
+                    <Button variant="ghost" size="sm" aria-label="Bookmark" @click="characterStore.bookmark(character.id)">
+                      <div
+                        :class="[
+                          character.bookmarked ? 'i-solar-star-bold' : 'i-solar-star-linear',
+                          'inline-block text-base',
+                          character.bookmarked ? 'text-amber-300 dark:text-amber-500' : 'text-neutral-400',
+                        ]"
+                      />
+                      <span
+                        :class="[
+                          'text-xs',
+                          character.bookmarked ? 'text-amber-500 dark:text-amber-300' : 'text-neutral-500',
+                        ]"
+                      >
+                        {{ formatCount(character.bookmarks) }}
+                      </span>
+                    </Button>
+                  </div>
+                  <div class="flex items-center justify-center">
+                    <Button variant="ghost" size="sm" aria-label="Like" @click="characterStore.like(character.id)">
+                      <div
+                        :class="[
+                          character.liked ? 'i-solar-heart-bold' : 'i-solar-heart-outline',
+                          'inline-block text-base',
+                          character.liked ? 'text-rose-500 dark:text-rose-400' : 'text-neutral-400',
+                        ]"
+                      />
+                      <span
+                        :class="[
+                          'text-xs',
+                          character.liked ? 'text-rose-500 dark:text-rose-400' : 'text-neutral-500',
+                        ]"
+                      >
+                        {{ formatCount(character.likes) }}
+                      </span>
+                    </Button>
+                  </div>
+                  <div class="flex items-center justify-end">
+                    <button
+                      type="button"
+                      class="flex flex-row items-center gap-1 rounded-full bg-neutral-900/65 pl-1.5 pr-2 py-1"
+                      @click="openCharacter(character.id)"
+                    >
+                      <div class="i-solar:chat-square-bold inline-block text-xs text-neutral-100" />
+                      <span class="text-xs text-neutral-100">Open</span>
+                    </button>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+
+          <div class="absolute left-0 top-0 z-0 h-full w-full">
+            <div class="absolute inset-0 z-2 h-full w-full bg-neutral-950/70 backdrop-blur-lg" />
+            <img
+              v-if="character.coverUrl"
+              :src="character.coverUrl"
+              :alt="character.name"
+              class="relative z-1 h-full w-full scale-300 object-contain transition duration-300 ease-in-out group-hover:scale-350"
+            >
+          </div>
+        </article>
+      </section>
+      </template>
     </div>
   </div>
 </template>
 
 <route lang="yaml">
 meta:
-  title: NSFW Workspace
+  title: NSFW Explore
 </route>
diff --git a/packages/stage-pages/src/pages/settings/account.vue b/packages/stage-pages/src/pages/settings/account.vue
new file mode 100644
index 0000000000..f2c029e577
--- /dev/null
+++ b/packages/stage-pages/src/pages/settings/account.vue
@@ -0,0 +1,101 @@
+<script setup lang="ts">
+import { useAuthStore } from '@proj-airi/stage-ui/stores/auth'
+import { Button, FieldCheckbox, FieldCombobox } from '@proj-airi/ui'
+import { computed, onMounted, reactive, ref, watch } from 'vue'
+
+const authStore = useAuthStore()
+const saving = ref(false)
+const saved = ref(false)
+const error = ref('')
+
+const form = reactive({
+  adultVerified: false,
+  allowSensitiveContent: false,
+  contentTier: 'standard' as 'standard' | 'sensitive' | 'explicit',
+})
+
+watch(() => authStore.profile, () => {
+  form.adultVerified = authStore.adultVerified
+  form.allowSensitiveContent = authStore.allowSensitiveContent
+  form.contentTier = authStore.contentTier
+}, { immediate: true, deep: true })
+
+const contentTierOptions = computed(() => [
+  { value: 'standard', label: 'Standard' },
+  { value: 'sensitive', label: 'Sensitive' },
+  { value: 'explicit', label: 'Explicit' },
+])
+
+onMounted(() => {
+  authStore.fetchProfile().catch(() => {})
+})
+
+async function save() {
+  saving.value = true
+  saved.value = false
+  error.value = ''
+
+  try {
+    await authStore.updateProfile({
+      adultVerified: form.adultVerified,
+      allowSensitiveContent: form.allowSensitiveContent,
+      contentTier: form.contentTier,
+    })
+    saved.value = true
+  }
+  catch (err) {
+    error.value = err instanceof Error ? err.message : 'Failed to save account settings'
+  }
+  finally {
+    saving.value = false
+  }
+}
+</script>
+
+<template>
+  <div class="flex flex-col gap-4 rounded-lg bg-neutral-50 p-4 dark:bg-neutral-800">
+    <FieldCheckbox
+      v-model="form.adultVerified"
+      label="Adult Verified"
+      description="Marks this account as eligible for age-gated experiences."
+    />
+
+    <FieldCheckbox
+      v-model="form.allowSensitiveContent"
+      label="Allow Sensitive Content"
+      description="Allows routes and requests that can enter the NSFW flow."
+    />
+
+    <FieldCombobox
+      v-model="form.contentTier"
+      label="Content Tier"
+      description="Choose the highest content level this account is allowed to access."
+      layout="horizontal"
+      :options="contentTierOptions"
+    />
+
+    <div class="flex items-center gap-3">
+      <Button :disabled="saving" @click="save">
+        {{ saving ? 'Saving...' : 'Save Account Settings' }}
+      </Button>
+      <span v-if="saved" class="text-sm text-emerald-600 dark:text-emerald-400">
+        Saved
+      </span>
+      <span v-if="error" class="text-sm text-rose-600 dark:text-rose-400">
+        {{ error }}
+      </span>
+    </div>
+  </div>
+</template>
+
+<route lang="yaml">
+meta:
+  layout: settings
+  title: Account
+  description: Account access and content gating
+  icon: i-solar:user-id-bold-duotone
+  settingsEntry: true
+  order: 15
+  stageTransition:
+    name: slide
+</route>
diff --git a/packages/stage-ui/package.json b/packages/stage-ui/package.json
index ecc0688877..7c63ce9c31 100644
--- a/packages/stage-ui/package.json
+++ b/packages/stage-ui/package.json
@@ -70,6 +70,7 @@
     "@proj-airi/model-driver-lipsync": "workspace:^",
     "@proj-airi/pipelines-audio": "workspace:^",
     "@proj-airi/server-sdk": "workspace:^",
+    "@proj-airi/server-sdk-shared": "workspace:^",
     "@proj-airi/stage-shared": "workspace:^",
     "@proj-airi/stage-ui-live2d": "workspace:^",
     "@proj-airi/stage-ui-three": "workspace:^",
diff --git a/packages/stage-ui/src/libs/auth.ts b/packages/stage-ui/src/libs/auth.ts
index 04bc0d8212..fdd731add9 100644
--- a/packages/stage-ui/src/libs/auth.ts
+++ b/packages/stage-ui/src/libs/auth.ts
@@ -84,6 +84,10 @@ export async function fetchSession() {
   if (data) {
     authStore.user = data.user
     authStore.session = data.session
+    try {
+      await authStore.fetchProfile()
+    }
+    catch {}
     return true
   }
 
diff --git a/packages/stage-ui/src/libs/hermes-transport.ts b/packages/stage-ui/src/libs/hermes-transport.ts
new file mode 100644
index 0000000000..51b6b5647e
--- /dev/null
+++ b/packages/stage-ui/src/libs/hermes-transport.ts
@@ -0,0 +1,88 @@
+import type { HermesReplyRequest, HermesReplyResponse } from '@proj-airi/server-sdk-shared'
+
+import { HERMES_URL } from './server'
+
+export type HermesReplyTransport = (request: HermesReplyRequest) => Promise<HermesReplyResponse>
+
+export function createStubHermesReply(request: HermesReplyRequest): HermesReplyResponse {
+  const userMessage = request.message.content.trim()
+  const personality = request.character.personaProfile.personality?.trim()
+  const prefix = personality ? `${personality}. ` : ''
+
+  if (request.route === 'nsfw' && (!request.user.adultVerified || !request.user.allowSensitiveContent || request.user.contentTier === 'standard')) {
+    return {
+      requestId: request.requestId,
+      route: request.route,
+      reply: {
+        role: 'assistant',
+        content: 'NSFW access is blocked for this account.',
+      },
+      runtime: {
+        replyModel: 'Hermes-4.3-36B',
+        routerModel: 'grok-4.20',
+        memoryModel: 'gpt-5-mini',
+      },
+      memoryUpdates: {
+        factsAdd: [],
+        factsRemove: [],
+      },
+      judge: {
+        score: null,
+        flags: ['nsfw_access_denied'],
+      },
+      sceneType: 'nsfw',
+    }
+  }
+
+  return {
+    requestId: request.requestId,
+    route: request.route,
+    reply: {
+      role: 'assistant',
+      content: `${prefix}${userMessage ? `You said: ${userMessage}` : 'Ready.'}`,
+    },
+    runtime: {
+      replyModel: 'Hermes-4.3-36B',
+      routerModel: 'grok-4.20',
+      memoryModel: 'gpt-5-mini',
+    },
+    memoryUpdates: {
+      summaryAppend: userMessage ? `User said: ${userMessage}` : undefined,
+      factsAdd: [],
+      factsRemove: [],
+    },
+    judge: {
+      score: null,
+      flags: [],
+    },
+    sceneType: request.route === 'nsfw' ? 'nsfw' : request.character.relationshipMode,
+  }
+}
+
+export async function generateHermesReplyViaTransport(
+  request: HermesReplyRequest,
+  transport?: HermesReplyTransport,
+): Promise<HermesReplyResponse> {
+  if (!transport)
+    return createStubHermesReply(request)
+
+  return await transport(request)
+}
+
+export function createHttpHermesTransport(baseUrl: string = HERMES_URL): HermesReplyTransport {
+  return async (request) => {
+    const response = await fetch(new URL('/v1/airi/generate-reply', baseUrl), {
+      method: 'POST',
+      headers: {
+        'content-type': 'application/json',
+      },
+      body: JSON.stringify(request),
+    })
+
+    if (!response.ok) {
+      throw new Error(`Hermes transport failed with status ${response.status}`)
+    }
+
+    return await response.json() as HermesReplyResponse
+  }
+}
diff --git a/packages/stage-ui/src/libs/hermes.ts b/packages/stage-ui/src/libs/hermes.ts
new file mode 100644
index 0000000000..8c0f0cf2fd
--- /dev/null
+++ b/packages/stage-ui/src/libs/hermes.ts
@@ -0,0 +1,94 @@
+import type {
+  HermesCharacterContext,
+  HermesConversationMessage,
+  HermesReplyRequest,
+  HermesUserContext,
+} from '@proj-airi/server-sdk-shared'
+import type { ChatHistoryItem } from '../types/chat'
+import type { Character } from '../types/character'
+
+import { nanoid } from 'nanoid'
+
+function stringifyContent(content: ChatHistoryItem['content']) {
+  if (typeof content === 'string')
+    return content
+
+  if (Array.isArray(content)) {
+    return content
+      .map((part) => {
+        if (typeof part !== 'object' || part == null)
+          return ''
+        if ('text' in part && typeof part.text === 'string')
+          return part.text
+        if ('type' in part && part.type === 'image_url')
+          return '[image]'
+        return ''
+      })
+      .filter(Boolean)
+      .join('\n')
+  }
+
+  return ''
+}
+
+function mapRole(role: ChatHistoryItem['role']): HermesConversationMessage['role'] {
+  if (role === 'system' || role === 'user' || role === 'assistant' || role === 'tool' || role === 'error')
+    return role
+  return 'user'
+}
+
+export function toHermesConversationMessage(message: ChatHistoryItem): HermesConversationMessage {
+  return {
+    id: message.id,
+    role: mapRole(message.role),
+    content: stringifyContent(message.content),
+  }
+}
+
+export function toHermesCharacterContext(character: Character): HermesCharacterContext {
+  return {
+    id: character.id,
+    visibility: character.visibility,
+    relationshipMode: character.relationshipMode,
+    nsfwEnabled: character.nsfwEnabled,
+    nsfwLevel: character.nsfwLevel,
+    personaProfile: {
+      personality: character.personaProfile?.personality,
+      scenario: character.personaProfile?.scenario,
+      speakingStyle: character.personaProfile?.speakingStyle,
+      starterMessages: character.personaProfile?.starterMessages,
+      boundaries: character.personaProfile?.boundaries,
+      memoryProfile: character.personaProfile?.memoryProfile,
+    },
+  }
+}
+
+export interface BuildHermesReplyRequestOptions {
+  route?: HermesReplyRequest['route']
+  requestId?: string
+  user: Partial<HermesUserContext> & Pick<HermesUserContext, 'id'>
+  character: Character
+  conversationId: string
+  recentMessages: ChatHistoryItem[]
+  message: ChatHistoryItem
+}
+
+export function buildHermesReplyRequest(options: BuildHermesReplyRequestOptions): HermesReplyRequest {
+  return {
+    requestId: options.requestId ?? nanoid(),
+    route: options.route ?? (options.character.nsfwEnabled && options.character.nsfwLevel !== 'none' ? 'nsfw' : 'normal'),
+    user: {
+      id: options.user.id,
+      adultVerified: options.user.adultVerified ?? false,
+      allowSensitiveContent: options.user.allowSensitiveContent ?? false,
+      subscriptionTier: options.user.subscriptionTier ?? 'free',
+      contentTier: options.user.contentTier ?? 'standard',
+    },
+    character: toHermesCharacterContext(options.character),
+    conversation: {
+      id: options.conversationId,
+      recentMessages: options.recentMessages.map(toHermesConversationMessage),
+    },
+    message: toHermesConversationMessage(options.message),
+  }
+}
diff --git a/packages/stage-ui/src/libs/index.ts b/packages/stage-ui/src/libs/index.ts
index afd67b8934..c265464b4c 100644
--- a/packages/stage-ui/src/libs/index.ts
+++ b/packages/stage-ui/src/libs/index.ts
@@ -1,5 +1,7 @@
 export * from './audio/manager'
 export * from './color-from-element'
+export * from './hermes'
+export * from './hermes-transport'
 export * from './providers'
 export * from './workers/types'
 export * from './workers/worker'
diff --git a/packages/stage-ui/src/libs/server.ts b/packages/stage-ui/src/libs/server.ts
index dd27eb710a..5074a0db4e 100644
--- a/packages/stage-ui/src/libs/server.ts
+++ b/packages/stage-ui/src/libs/server.ts
@@ -1 +1,3 @@
 export const SERVER_URL = import.meta.env.VITE_SERVER_URL || 'https://api.airi.build'
+export const HERMES_URL = import.meta.env.VITE_HERMES_URL || 'http://127.0.0.1:8643'
+export const USE_HERMES_CHAT = import.meta.env.VITE_USE_HERMES_CHAT === 'true'
diff --git a/packages/stage-ui/src/stores/auth.ts b/packages/stage-ui/src/stores/auth.ts
index 47981b3480..746c4e1357 100644
--- a/packages/stage-ui/src/stores/auth.ts
+++ b/packages/stage-ui/src/stores/auth.ts
@@ -22,6 +22,15 @@ export const useAuthStore = defineStore('auth', () => {
   const token = useLocalStorage<string | null>('auth/v1/token', null)
   const isAuthenticated = computed(() => !!user.value && !!session.value)
   const userId = computed(() => user.value?.id ?? 'local')
+  const profile = computed(() => (user.value ?? {}) as User & {
+    adultVerified?: boolean
+    allowSensitiveContent?: boolean
+    contentTier?: 'standard' | 'sensitive' | 'explicit'
+  })
+  const adultVerified = computed(() => profile.value.adultVerified ?? false)
+  const allowSensitiveContent = computed(() => profile.value.allowSensitiveContent ?? false)
+  const contentTier = computed<'standard' | 'sensitive' | 'explicit'>(() => profile.value.contentTier ?? 'standard')
+  const canAccessNsfw = computed(() => adultVerified.value && allowSensitiveContent.value && contentTier.value !== 'standard')
 
   const credits = useLocalStorage<number>('user/v1/flux', 0)
 
@@ -95,6 +104,44 @@ export const useAuthStore = defineStore('auth', () => {
     }
   }
 
+  const fetchProfile = async () => {
+    if (!isAuthenticated.value)
+      return null
+
+    const res = await client.api.v1.users.me.$get()
+    if (!res.ok)
+      throw new Error('Failed to fetch user profile')
+
+    const data = await res.json()
+    user.value = {
+      ...(user.value ?? {}),
+      ...data,
+    } as User
+    return user.value
+  }
+
+  const updateProfile = async (input: {
+    adultVerified: boolean
+    allowSensitiveContent: boolean
+    contentTier: 'standard' | 'sensitive' | 'explicit'
+  }) => {
+    if (!isAuthenticated.value)
+      throw new Error('Not authenticated')
+
+    const res = await client.api.v1.users.me.$patch({
+      json: input,
+    })
+    if (!res.ok)
+      throw new Error('Failed to update user profile')
+
+    const data = await res.json()
+    user.value = {
+      ...(user.value ?? {}),
+      ...data,
+    } as User
+    return user.value
+  }
+
   watch(isAuthenticated, async (val) => {
     if (val) {
       updateCredits()
@@ -109,11 +156,18 @@ export const useAuthStore = defineStore('auth', () => {
   return {
     user,
     userId,
+    profile,
     session,
     token,
     isAuthenticated,
+    adultVerified,
+    allowSensitiveContent,
+    contentTier,
+    canAccessNsfw,
     credits,
     updateCredits,
+    fetchProfile,
+    updateProfile,
     needsLogin,
     onAuthenticated,
     onLogout,
diff --git a/packages/stage-ui/src/stores/chat.ts b/packages/stage-ui/src/stores/chat.ts
index 97d27c44c4..5797dceed7 100644
--- a/packages/stage-ui/src/stores/chat.ts
+++ b/packages/stage-ui/src/stores/chat.ts
@@ -1,3 +1,4 @@
+import type { HermesReplyRequest, HermesReplyResponse } from '@proj-airi/server-sdk-shared'
 import type { WebSocketEventInputs } from '@proj-airi/server-sdk'
 import type { ChatProvider } from '@xsai-ext/providers/utils'
 import type { CommonContentPart, Message, ToolMessage } from '@xsai/shared-chat'
@@ -11,11 +12,17 @@ import { defineStore, storeToRefs } from 'pinia'
 import { ref, toRaw } from 'vue'
 
 import { useAnalytics } from '../composables'
+import { buildHermesReplyRequest } from '../libs/hermes'
+import { createHttpHermesTransport, generateHermesReplyViaTransport } from '../libs/hermes-transport'
+import { USE_HERMES_CHAT } from '../libs/server'
 import { useLlmmarkerParser } from '../composables/llm-marker-parser'
 import { categorizeResponse, createStreamingCategorizer } from '../composables/response-categoriser'
+import { useAuthStore } from './auth'
+import { useCharacterStore } from './characters'
 import { createDatetimeContext } from './chat/context-providers'
 import { useChatContextStore } from './chat/context-store'
 import { createChatHooks } from './chat/hooks'
+import { useHermesMemoryStore } from './chat/hermes-memory-store'
 import { useChatSessionStore } from './chat/session-store'
 import { useChatStreamStore } from './chat/stream-store'
 import { useLLM } from './llm'
@@ -28,6 +35,8 @@ interface SendOptions {
   attachments?: { type: 'image', data: string, mimeType: string }[]
   tools?: StreamOptions['tools']
   input?: WebSocketEventInputs
+  useHermes?: boolean
+  hermesRoute?: HermesReplyRequest['route']
 }
 
 interface ForkOptions {
@@ -54,10 +63,13 @@ export const useChatOrchestratorStore = defineStore('chat-orchestrator', () => {
   const consciousnessStore = useConsciousnessStore()
   const { activeProvider } = storeToRefs(consciousnessStore)
   const { trackFirstMessage } = useAnalytics()
+  const authStore = useAuthStore()
+  const characterStore = useCharacterStore()
 
   const chatSession = useChatSessionStore()
   const chatStream = useChatStreamStore()
   const chatContext = useChatContextStore()
+  const hermesMemoryStore = useHermesMemoryStore()
   const { activeSessionId } = storeToRefs(chatSession)
   const { streamingMessage } = storeToRefs(chatStream)
 
@@ -288,6 +300,55 @@ export const useChatOrchestratorStore = defineStore('chat-orchestrator', () => {
       await hooks.emitAfterMessageComposedHooks(sendingMessage, streamingMessageContext)
       await hooks.emitBeforeSendHooks(sendingMessage, streamingMessageContext)
 
+      if (options.useHermes || USE_HERMES_CHAT) {
+        const hermesResponse = await generateHermesReplyForSession(sendingMessage, {
+          sessionId,
+          route: options.hermesRoute,
+          transport: createHttpHermesTransport(),
+        })
+
+        if (!hermesResponse)
+          throw new Error('Failed to generate Hermes reply request')
+
+        if (shouldAbort())
+          return
+
+        hermesMemoryStore.applyResponse(sessionId, hermesResponse)
+        const memoryContext = hermesMemoryStore.createContextMessage(sessionId)
+        if (memoryContext)
+          chatContext.ingestContextMessage(memoryContext)
+
+        buildingMessage.content = hermesResponse.reply.content
+        buildingMessage.slices = hermesResponse.reply.content
+          ? [{
+              type: 'text',
+              text: hermesResponse.reply.content,
+            }]
+          : []
+
+        updateUI()
+
+        if (!isStaleGeneration()) {
+          chatSession.appendSessionMessage(sessionId, toRaw(buildingMessage))
+        }
+
+        await hooks.emitStreamEndHooks(streamingMessageContext)
+        await hooks.emitAssistantResponseEndHooks(hermesResponse.reply.content, streamingMessageContext)
+        await hooks.emitAfterSendHooks(sendingMessage, streamingMessageContext)
+        await hooks.emitAssistantMessageHooks({ ...buildingMessage }, hermesResponse.reply.content, streamingMessageContext)
+        await hooks.emitChatTurnCompleteHooks({
+          output: { ...buildingMessage },
+          outputText: hermesResponse.reply.content,
+          toolCalls: [],
+        }, streamingMessageContext)
+
+        if (isForegroundSession()) {
+          streamingMessage.value = { role: 'assistant', content: '', slices: [], tool_results: [] }
+        }
+
+        return
+      }
+
       let fullText = ''
       const headers = (options.providerConfig?.headers || {}) as Record<string, string>
 
@@ -410,11 +471,90 @@ export const useChatOrchestratorStore = defineStore('chat-orchestrator', () => {
       : []
   }
 
+  function buildHermesRequestForSession(
+    sendingMessage: string,
+    options: {
+      sessionId?: string
+      route?: HermesReplyRequest['route']
+      adultVerified?: boolean
+      allowSensitiveContent?: boolean
+      subscriptionTier?: HermesReplyRequest['user']['subscriptionTier']
+    } = {},
+  ) {
+    const sessionId = options.sessionId ?? activeSessionId.value
+    if (!sessionId)
+      return null
+
+    const activeCharacterId = characterStore.activeCharacterId
+    if (!activeCharacterId)
+      return null
+
+    const character = characterStore.getCharacter(activeCharacterId)
+    if (!character)
+      return null
+
+    const sessionMessages = chatSession.getSessionMessages(sessionId)
+    const lastMessage = sessionMessages.at(-1)
+    const recentMessages = lastMessage?.role === 'user' && typeof lastMessage.content === 'string' && lastMessage.content === sendingMessage
+      ? sessionMessages.slice(0, -1)
+      : sessionMessages
+
+    return buildHermesReplyRequest({
+      route: options.route,
+      user: {
+        id: authStore.userId,
+        adultVerified: options.adultVerified ?? authStore.adultVerified,
+        allowSensitiveContent: options.allowSensitiveContent ?? authStore.allowSensitiveContent,
+        subscriptionTier: options.subscriptionTier,
+        contentTier: authStore.contentTier,
+      },
+      character,
+      conversationId: sessionId,
+      recentMessages,
+      message: {
+        role: 'user',
+        content: sendingMessage,
+      },
+    })
+  }
+
+  async function generateHermesReplyForSession(
+    sendingMessage: string,
+    options: {
+      sessionId?: string
+      route?: HermesReplyRequest['route']
+      adultVerified?: boolean
+      allowSensitiveContent?: boolean
+      subscriptionTier?: HermesReplyRequest['user']['subscriptionTier']
+      transport?: (request: HermesReplyRequest) => Promise<HermesReplyResponse>
+    } = {},
+  ) {
+    const request = buildHermesRequestForSession(sendingMessage, options)
+    if (!request)
+      return null
+
+    return await generateHermesReplyViaTransport(request, options.transport)
+  }
+
+  async function ingestViaHermes(
+    sendingMessage: string,
+    options: Omit<SendOptions, 'useHermes'>,
+    targetSessionId?: string,
+  ) {
+    return await ingest(sendingMessage, {
+      ...options,
+      useHermes: true,
+    }, targetSessionId)
+  }
+
   return {
     sending,
 
     ingest,
+    ingestViaHermes,
     ingestOnFork,
+    buildHermesRequestForSession,
+    generateHermesReplyForSession,
     cancelPendingSends,
 
     clearHooks: hooks.clearHooks,
diff --git a/packages/stage-ui/src/stores/chat/hermes-memory-store.ts b/packages/stage-ui/src/stores/chat/hermes-memory-store.ts
new file mode 100644
index 0000000000..1be79ffcc1
--- /dev/null
+++ b/packages/stage-ui/src/stores/chat/hermes-memory-store.ts
@@ -0,0 +1,91 @@
+import type { HermesReplyResponse } from '@proj-airi/server-sdk-shared'
+import type { ContextMessage } from '../../types/chat'
+
+import { StorageSerializers, useLocalStorage } from '@vueuse/core'
+import { ContextUpdateStrategy } from '@proj-airi/server-sdk'
+import { nanoid } from 'nanoid'
+import { defineStore } from 'pinia'
+
+interface HermesSessionMemoryRecord {
+  sessionId: string
+  summary: string
+  facts: string[]
+  updatedAt: number
+}
+
+function dedupeFacts(facts: string[]) {
+  return Array.from(new Set(facts.map(item => item.trim()).filter(Boolean)))
+}
+
+export const useHermesMemoryStore = defineStore('chat-hermes-memory', () => {
+  const records = useLocalStorage<Record<string, HermesSessionMemoryRecord>>('chat/v1/hermes-memory', {}, {
+    serializer: StorageSerializers.object,
+  })
+
+  function getSessionMemory(sessionId: string) {
+    return records.value[sessionId]
+  }
+
+  function applyResponse(sessionId: string, response: HermesReplyResponse) {
+    const current = records.value[sessionId] ?? {
+      sessionId,
+      summary: '',
+      facts: [],
+      updatedAt: 0,
+    }
+
+    const summary = response.memoryUpdates.summaryAppend?.trim()
+      ? [current.summary, response.memoryUpdates.summaryAppend.trim()].filter(Boolean).join('\n')
+      : current.summary
+
+    const facts = dedupeFacts([
+      ...current.facts.filter(fact => !response.memoryUpdates.factsRemove.includes(fact)),
+      ...response.memoryUpdates.factsAdd,
+    ])
+
+    records.value = {
+      ...records.value,
+      [sessionId]: {
+        sessionId,
+        summary,
+        facts,
+        updatedAt: Date.now(),
+      },
+    }
+  }
+
+  function createContextMessage(sessionId: string): ContextMessage | null {
+    const record = records.value[sessionId]
+    if (!record || (!record.summary && record.facts.length === 0))
+      return null
+
+    const textParts = [
+      record.summary ? `Summary:\n${record.summary}` : '',
+      record.facts.length ? `Facts:\n- ${record.facts.join('\n- ')}` : '',
+    ].filter(Boolean)
+
+    return {
+      id: nanoid(),
+      contextId: `hermes:memory:${sessionId}`,
+      strategy: ContextUpdateStrategy.ReplaceSelf,
+      text: textParts.join('\n\n'),
+      createdAt: Date.now(),
+      metadata: {
+        source: {
+          id: `hermes:memory:${sessionId}`,
+          kind: 'plugin',
+          plugin: {
+            id: 'airi:hermes:memory',
+          },
+        },
+      },
+    }
+  }
+
+  return {
+    records,
+    getSessionMemory,
+    applyResponse,
+    createContextMessage,
+  }
+})

From b428bb612d6be5b56f4483e88d705c27d18bb9fe Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Mon, 30 Mar 2026 19:03:33 +0200
Subject: [PATCH 04/30] feat: refine nsfw hermes chat routing

---
 docs/content/en/nsfw-companion-index.md       |  3 ++
 docs/content/en/nsfw-companion-todo.md        |  2 +-
 packages/stage-ui/src/stores/chat.ts          | 36 ++++++++++++++++++-
 .../src/stores/chat/hermes-memory-store.ts    | 15 ++++++++
 4 files changed, 54 insertions(+), 2 deletions(-)

diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 91b66feb75..149748fcac 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -51,10 +51,12 @@ Role:
   - `USE_HERMES_CHAT`
 - `packages/stage-ui/src/stores/chat.ts`
   - builds Hermes payloads from active sessions
+  - resolves `normal` vs `nsfw` Hermes routes from character and user gating
   - sends chat turns through Hermes when enabled
   - applies Hermes memory updates
 - `packages/stage-ui/src/stores/chat/hermes-memory-store.ts`
   - per-session local persistence for summaries and facts
+  - stores route, scene type, judge score, and judge flags
 
 ### Auth and User Gating
 
@@ -168,6 +170,7 @@ Role:
 - Hermes context assembly
 - Hermes deterministic reply assembly
 - Hermes memory delta return path into AIRI
+- AIRI-side route resolution for normal vs NSFW Hermes turns
 
 ### Still Open
 
diff --git a/docs/content/en/nsfw-companion-todo.md b/docs/content/en/nsfw-companion-todo.md
index 34ac13f79e..fcf6633de0 100644
--- a/docs/content/en/nsfw-companion-todo.md
+++ b/docs/content/en/nsfw-companion-todo.md
@@ -22,7 +22,7 @@ This is the implementation checklist for the AIRI + Hermes companion stack.
 
 ### Chat
 
-- [ ] Route `normal` and `nsfw` chat turns separately.
+- [x] Route `normal` and `nsfw` chat turns separately.
 - [x] Send Hermes request payloads from the active session.
 - [x] Persist Hermes memory deltas after each turn.
 - [ ] Add judge feedback handling for low-quality replies.
diff --git a/packages/stage-ui/src/stores/chat.ts b/packages/stage-ui/src/stores/chat.ts
index 5797dceed7..1f600b1972 100644
--- a/packages/stage-ui/src/stores/chat.ts
+++ b/packages/stage-ui/src/stores/chat.ts
@@ -4,6 +4,7 @@ import type { ChatProvider } from '@xsai-ext/providers/utils'
 import type { CommonContentPart, Message, ToolMessage } from '@xsai/shared-chat'
 
 import type { ChatAssistantMessage, ChatSlices, ChatStreamEventContext, StreamingAssistantMessage } from '../types/chat'
+import type { Character } from '../types/character'
 import type { StreamEvent, StreamOptions } from './llm'
 
 import { createQueue } from '@proj-airi/stream-kit'
@@ -39,6 +40,25 @@ interface SendOptions {
   hermesRoute?: HermesReplyRequest['route']
 }
 
+function resolveHermesRoute(
+  route: HermesReplyRequest['route'] | undefined,
+  character: Character | null | undefined,
+  canAccessNsfw: boolean,
+): HermesReplyRequest['route'] {
+  if (route)
+    return route
+
+  if (
+    character?.nsfwEnabled
+    && character.nsfwLevel !== 'none'
+    && canAccessNsfw
+  ) {
+    return 'nsfw'
+  }
+
+  return 'normal'
+}
+
 interface ForkOptions {
   fromSessionId?: string
   atIndex?: number
@@ -493,6 +513,12 @@ export const useChatOrchestratorStore = defineStore('chat-orchestrator', () => {
     if (!character)
       return null
 
+    const route = resolveHermesRoute(
+      options.route,
+      character,
+      authStore.canAccessNsfw,
+    )
+
     const sessionMessages = chatSession.getSessionMessages(sessionId)
     const lastMessage = sessionMessages.at(-1)
     const recentMessages = lastMessage?.role === 'user' && typeof lastMessage.content === 'string' && lastMessage.content === sendingMessage
@@ -500,7 +526,7 @@ export const useChatOrchestratorStore = defineStore('chat-orchestrator', () => {
       : sessionMessages
 
     return buildHermesReplyRequest({
-      route: options.route,
+      route,
       user: {
         id: authStore.userId,
         adultVerified: options.adultVerified ?? authStore.adultVerified,
@@ -541,9 +567,17 @@ export const useChatOrchestratorStore = defineStore('chat-orchestrator', () => {
     options: Omit<SendOptions, 'useHermes'>,
     targetSessionId?: string,
   ) {
+    const activeCharacterId = characterStore.activeCharacterId
+    const character = activeCharacterId ? characterStore.getCharacter(activeCharacterId) : null
+
     return await ingest(sendingMessage, {
       ...options,
       useHermes: true,
+      hermesRoute: resolveHermesRoute(
+        options.hermesRoute,
+        character,
+        authStore.canAccessNsfw,
+      ),
     }, targetSessionId)
   }
 
diff --git a/packages/stage-ui/src/stores/chat/hermes-memory-store.ts b/packages/stage-ui/src/stores/chat/hermes-memory-store.ts
index 1be79ffcc1..4930204e34 100644
--- a/packages/stage-ui/src/stores/chat/hermes-memory-store.ts
+++ b/packages/stage-ui/src/stores/chat/hermes-memory-store.ts
@@ -10,6 +10,10 @@ interface HermesSessionMemoryRecord {
   sessionId: string
   summary: string
   facts: string[]
+  lastRoute: HermesReplyResponse['route'] | null
+  lastSceneType: HermesReplyResponse['sceneType'] | null
+  judgeScore: HermesReplyResponse['judge']['score']
+  judgeFlags: string[]
   updatedAt: number
 }
 
@@ -31,6 +35,10 @@ export const useHermesMemoryStore = defineStore('chat-hermes-memory', () => {
       sessionId,
       summary: '',
       facts: [],
+      lastRoute: null,
+      lastSceneType: null,
+      judgeScore: null,
+      judgeFlags: [],
       updatedAt: 0,
     }
 
@@ -49,6 +57,10 @@ export const useHermesMemoryStore = defineStore('chat-hermes-memory', () => {
         sessionId,
         summary,
         facts,
+        lastRoute: response.route,
+        lastSceneType: response.sceneType ?? null,
+        judgeScore: response.judge.score ?? null,
+        judgeFlags: dedupeFacts(response.judge.flags),
         updatedAt: Date.now(),
       },
     }
@@ -60,6 +72,9 @@ export const useHermesMemoryStore = defineStore('chat-hermes-memory', () => {
       return null
 
     const textParts = [
+      record.lastRoute ? `Route: ${record.lastRoute}` : '',
+      record.lastSceneType ? `Scene: ${record.lastSceneType}` : '',
+      record.judgeFlags.length ? `Quality flags:\n- ${record.judgeFlags.join('\n- ')}` : '',
       record.summary ? `Summary:\n${record.summary}` : '',
       record.facts.length ? `Facts:\n- ${record.facts.join('\n- ')}` : '',
     ].filter(Boolean)

From 046903fd1a818ea28ad7f9d6369076a11bab666c Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Mon, 30 Mar 2026 20:06:47 +0200
Subject: [PATCH 05/30] feat: add nsfw image prompt contracts

---
 docs/content/en/nsfw-companion-index.md       |   2 +
 docs/content/en/nsfw-memory-schema.md         | 104 ++++++++++++++++++
 packages/server-schema/src/hermes-contract.ts |  23 ++++
 packages/server-sdk-shared/src/index.ts       |  22 ++++
 .../stage-ui/src/libs/hermes-transport.ts     |  44 +++++++-
 packages/stage-ui/src/libs/hermes.ts          |  33 ++++++
 6 files changed, 227 insertions(+), 1 deletion(-)
 create mode 100644 docs/content/en/nsfw-memory-schema.md

diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 149748fcac..548912f7f8 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -188,5 +188,7 @@ Role:
   - stack decisions and model strategy
 - `docs/content/en/nsfw-companion-todo.md`
   - implementation checklist
+- `docs/content/en/nsfw-memory-schema.md`
+  - memory ownership split for Hermes, ClawMem, and AIRI
 - `docs/content/en/nsfw-companion-index.md`
   - this file index
diff --git a/docs/content/en/nsfw-memory-schema.md b/docs/content/en/nsfw-memory-schema.md
new file mode 100644
index 0000000000..5bb6860f02
--- /dev/null
+++ b/docs/content/en/nsfw-memory-schema.md
@@ -0,0 +1,104 @@
+# NSFW Memory Schema
+
+This document defines the intended memory split for the AIRI + Hermes + ClawMem stack.
+
+## Hermes Memory
+
+Use Hermes persistent memory for stack and operator knowledge only.
+
+### MEMORY.md
+
+Store:
+
+- repo ownership
+- runtime topology
+- runbooks
+- service boundaries
+- known tool quirks
+- stable engineering conventions
+
+Do not store:
+
+- relationship milestones
+- sexual preferences
+- per-character callbacks
+- long chat history
+
+### USER.md
+
+Store:
+
+- user communication preferences
+- workflow constraints
+- style and response preferences
+- project priorities
+
+Do not store:
+
+- character lore
+- session transcripts
+- intimate companion state
+
+## ClawMem
+
+Use ClawMem for long-term companion memory keyed by user and character.
+
+### Suggested JSON shape
+
+```json
+{
+  "user_id": "user_123",
+  "character_id": "char_456",
+  "display_name": "Alex",
+  "preferred_tone": "gentle and playful",
+  "liked_topics": ["late night chats", "travel", "teasing banter"],
+  "disliked_topics": ["public embarrassment"],
+  "hard_boundaries": ["violence", "humiliation"],
+  "soft_boundaries": ["jealousy"],
+  "relationship_stage": "romance",
+  "relationship_milestones": [
+    "first date roleplay established",
+    "shared recurring coffee shop scenario"
+  ],
+  "important_callbacks": [
+    "calls the user moonbeam",
+    "remembers the red dress request"
+  ],
+  "intimate_preferences": [
+    "slow pacing",
+    "compliment-heavy tone"
+  ],
+  "scene_continuity_notes": [
+    "current scene set in penthouse bedroom",
+    "character is calm and affectionate"
+  ],
+  "last_emotional_state": "warm and attached",
+  "memory_confidence": 0.86,
+  "updated_at": "2026-03-30T18:00:00Z"
+}
+```
+
+## AIRI Database
+
+Use AIRI for structured product and entitlement data.
+
+Store:
+
+- `adultVerified`
+- `allowSensitiveContent`
+- `contentTier`
+- `visibility`
+- `nsfwEnabled`
+- `nsfwLevel`
+- `relationshipMode`
+- `personaProfile`
+- gallery records
+- image jobs
+- credits
+- subscriptions
+
+## Rule of Thumb
+
+- Hermes memory: system knowledge
+- ClawMem: relationship knowledge
+- AIRI database: product data
diff --git a/packages/server-schema/src/hermes-contract.ts b/packages/server-schema/src/hermes-contract.ts
index af9f02d34d..df54dec494 100644
--- a/packages/server-schema/src/hermes-contract.ts
+++ b/packages/server-schema/src/hermes-contract.ts
@@ -115,6 +115,18 @@ export const HermesReplyRequestSchema = object({
   message: HermesConversationMessageSchema,
 })
 
+export const HermesImagePromptRequestSchema = object({
+  requestId: string(),
+  route: HermesRouteSchema,
+  user: HermesUserContextSchema,
+  character: HermesCharacterContextSchema,
+  prompt: string(),
+  style: optional(string()),
+  mood: optional(string()),
+  framing: optional(string()),
+  aspectRatio: optional(string()),
+})
+
 export const HermesRuntimeSelectionSchema = object({
   replyModel: string(),
   routerModel: string(),
@@ -142,6 +154,15 @@ export const HermesReplyResponseSchema = object({
   sceneType: optional(HermesSceneTypeSchema),
 })
 
+export const HermesImagePromptResponseSchema = object({
+  requestId: string(),
+  route: HermesRouteSchema,
+  prompt: string(),
+  negativePrompt: string(),
+  tags: array(string()),
+  sceneType: optional(HermesSceneTypeSchema),
+})
+
 export type HermesRoute = InferOutput<typeof HermesRouteSchema>
 export type HermesSubscriptionTier = InferOutput<typeof HermesSubscriptionTierSchema>
 export type HermesContentTier = InferOutput<typeof HermesContentTierSchema>
@@ -151,7 +172,9 @@ export type HermesCharacterContext = InferOutput<typeof HermesCharacterContextSc
 export type HermesConversationMessage = InferOutput<typeof HermesConversationMessageSchema>
 export type HermesConversationContext = InferOutput<typeof HermesConversationContextSchema>
 export type HermesReplyRequest = InferOutput<typeof HermesReplyRequestSchema>
+export type HermesImagePromptRequest = InferOutput<typeof HermesImagePromptRequestSchema>
 export type HermesRuntimeSelection = InferOutput<typeof HermesRuntimeSelectionSchema>
 export type HermesMemoryUpdates = InferOutput<typeof HermesMemoryUpdatesSchema>
 export type HermesJudgeResult = InferOutput<typeof HermesJudgeResultSchema>
 export type HermesReplyResponse = InferOutput<typeof HermesReplyResponseSchema>
+export type HermesImagePromptResponse = InferOutput<typeof HermesImagePromptResponseSchema>
diff --git a/packages/server-sdk-shared/src/index.ts b/packages/server-sdk-shared/src/index.ts
index 312c2d3f44..e091fe87c1 100644
--- a/packages/server-sdk-shared/src/index.ts
+++ b/packages/server-sdk-shared/src/index.ts
@@ -44,6 +44,18 @@ export interface HermesReplyRequest {
   message: HermesConversationMessage
 }
 
+export interface HermesImagePromptRequest {
+  requestId: string
+  route: 'normal' | 'nsfw'
+  user: HermesUserContext
+  character: HermesCharacterContext
+  prompt: string
+  style?: string
+  mood?: string
+  framing?: string
+  aspectRatio?: string
+}
+
 export interface HermesReplyResponse {
   requestId: string
   route: 'normal' | 'nsfw'
@@ -65,6 +77,15 @@ export interface HermesReplyResponse {
   sceneType?: 'general' | 'romance' | 'roleplay' | 'nsfw' | 'support'
 }
 
+export interface HermesImagePromptResponse {
+  requestId: string
+  route: 'normal' | 'nsfw'
+  prompt: string
+  negativePrompt: string
+  tags: string[]
+  sceneType?: 'general' | 'romance' | 'roleplay' | 'nsfw' | 'support'
+}
+
 export interface WireMessage {
   id: string
   chatId: string
@@ -109,3 +130,4 @@ export const sendMessages = defineInvokeEventa<SendMessagesResponse, SendMessage
 export const pullMessages = defineInvokeEventa<PullMessagesResponse, PullMessagesRequest>('chat:pull-messages')
 export const newMessages = defineOutboundEventa<NewMessagesPayload>('chat:new-messages')
 export const generateHermesReply = defineInvokeEventa<HermesReplyResponse, HermesReplyRequest>('hermes:generate-reply')
+export const generateHermesImagePrompt = defineInvokeEventa<HermesImagePromptResponse, HermesImagePromptRequest>('hermes:generate-image-prompt')
diff --git a/packages/stage-ui/src/libs/hermes-transport.ts b/packages/stage-ui/src/libs/hermes-transport.ts
index 51b6b5647e..76d870b9d4 100644
--- a/packages/stage-ui/src/libs/hermes-transport.ts
+++ b/packages/stage-ui/src/libs/hermes-transport.ts
@@ -1,8 +1,14 @@
-import type { HermesReplyRequest, HermesReplyResponse } from '@proj-airi/server-sdk-shared'
+import type {
+  HermesImagePromptRequest,
+  HermesImagePromptResponse,
+  HermesReplyRequest,
+  HermesReplyResponse,
+} from '@proj-airi/server-sdk-shared'
 
 import { HERMES_URL } from './server'
 
 export type HermesReplyTransport = (request: HermesReplyRequest) => Promise<HermesReplyResponse>
+export type HermesImagePromptTransport = (request: HermesImagePromptRequest) => Promise<HermesImagePromptResponse>
 
 export function createStubHermesReply(request: HermesReplyRequest): HermesReplyResponse {
   const userMessage = request.message.content.trim()
@@ -86,3 +92,39 @@ export function createHttpHermesTransport(baseUrl: string = HERMES_URL): HermesR
     return await response.json() as HermesReplyResponse
   }
 }
+
+export async function generateHermesImagePromptViaTransport(
+  request: HermesImagePromptRequest,
+  transport?: HermesImagePromptTransport,
+): Promise<HermesImagePromptResponse> {
+  if (!transport) {
+    return {
+      requestId: request.requestId,
+      route: request.route,
+      prompt: request.prompt,
+      negativePrompt: '',
+      tags: [],
+      sceneType: request.route === 'nsfw' ? 'nsfw' : request.character.relationshipMode,
+    }
+  }
+
+  return await transport(request)
+}
+
+export function createHttpHermesImagePromptTransport(baseUrl: string = HERMES_URL): HermesImagePromptTransport {
+  return async (request) => {
+    const response = await fetch(new URL('/v1/airi/generate-image-prompt', baseUrl), {
+      method: 'POST',
+      headers: {
+        'content-type': 'application/json',
+      },
+      body: JSON.stringify(request),
+    })
+
+    if (!response.ok) {
+      throw new Error(`Hermes image prompt transport failed with status ${response.status}`)
+    }
+
+    return await response.json() as HermesImagePromptResponse
+  }
+}
diff --git a/packages/stage-ui/src/libs/hermes.ts b/packages/stage-ui/src/libs/hermes.ts
index 8c0f0cf2fd..e920266cbf 100644
--- a/packages/stage-ui/src/libs/hermes.ts
+++ b/packages/stage-ui/src/libs/hermes.ts
@@ -1,6 +1,7 @@
 import type {
   HermesCharacterContext,
   HermesConversationMessage,
+  HermesImagePromptRequest,
   HermesReplyRequest,
   HermesUserContext,
 } from '@proj-airi/server-sdk-shared'
@@ -73,6 +74,18 @@ export interface BuildHermesReplyRequestOptions {
   message: ChatHistoryItem
 }
 
+export interface BuildHermesImagePromptRequestOptions {
+  route?: HermesImagePromptRequest['route']
+  requestId?: string
+  user: Partial<HermesUserContext> & Pick<HermesUserContext, 'id'>
+  character: Character
+  prompt: string
+  style?: string
+  mood?: string
+  framing?: string
+  aspectRatio?: string
+}
+
 export function buildHermesReplyRequest(options: BuildHermesReplyRequestOptions): HermesReplyRequest {
   return {
     requestId: options.requestId ?? nanoid(),
@@ -92,3 +105,23 @@ export function buildHermesReplyRequest(options: BuildHermesReplyRequestOptions)
     message: toHermesConversationMessage(options.message),
   }
 }
+
+export function buildHermesImagePromptRequest(options: BuildHermesImagePromptRequestOptions): HermesImagePromptRequest {
+  return {
+    requestId: options.requestId ?? nanoid(),
+    route: options.route ?? (options.character.nsfwEnabled && options.character.nsfwLevel !== 'none' ? 'nsfw' : 'normal'),
+    user: {
+      id: options.user.id,
+      adultVerified: options.user.adultVerified ?? false,
+      allowSensitiveContent: options.user.allowSensitiveContent ?? false,
+      subscriptionTier: options.user.subscriptionTier ?? 'free',
+      contentTier: options.user.contentTier ?? 'standard',
+    },
+    character: toHermesCharacterContext(options.character),
+    prompt: options.prompt,
+    style: options.style,
+    mood: options.mood,
+    framing: options.framing,
+    aspectRatio: options.aspectRatio,
+  }
+}

From 585e644f4f5a22492b64b251c77434201babf39d Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 00:29:07 +0200
Subject: [PATCH 06/30] feat: add nsfw media queue and comfyui consumer

---
 apps/server/docker-compose.yml                |  17 +
 apps/server/drizzle/0010_nsfw_media.sql       |  36 ++
 apps/server/drizzle/meta/_journal.json        |   7 +
 apps/server/package.json                      |   1 +
 apps/server/src/app.ts                        |  32 +-
 .../server/src/bin/run-nsfw-image-consumer.ts |  94 +++++
 apps/server/src/bin/run.ts                    |  10 +-
 apps/server/src/libs/env.ts                   |   9 +-
 apps/server/src/routes/nsfw-media/index.ts    |  70 ++++
 apps/server/src/routes/nsfw-media/schema.ts   |  22 ++
 apps/server/src/schemas/index.ts              |   1 +
 apps/server/src/schemas/nsfw-media.ts         |  50 +++
 .../services/nsfw-image-consumer-handler.ts   | 207 ++++++++++
 apps/server/src/services/nsfw-image-events.ts | 117 ++++++
 apps/server/src/services/nsfw-media.ts        |  76 ++++
 apps/server/src/utils/redis-keys.ts           |   1 +
 docs/content/en/nsfw-companion-index.md       |  49 ++-
 docs/content/en/nsfw-companion-todo.md        |  17 +-
 packages/stage-pages/src/pages/nsfw/[id].vue  |   6 +
 .../stage-pages/src/pages/nsfw/gallery.vue    | 139 +++++++
 .../stage-pages/src/pages/nsfw/generate.vue   | 358 ++++++++++++++++++
 packages/stage-pages/src/pages/nsfw/index.vue |   9 +
 packages/stage-ui/src/stores/nsfw-media.ts    | 130 +++++++
 23 files changed, 1445 insertions(+), 13 deletions(-)
 create mode 100644 apps/server/drizzle/0010_nsfw_media.sql
 create mode 100644 apps/server/src/bin/run-nsfw-image-consumer.ts
 create mode 100644 apps/server/src/routes/nsfw-media/index.ts
 create mode 100644 apps/server/src/routes/nsfw-media/schema.ts
 create mode 100644 apps/server/src/schemas/nsfw-media.ts
 create mode 100644 apps/server/src/services/nsfw-image-consumer-handler.ts
 create mode 100644 apps/server/src/services/nsfw-image-events.ts
 create mode 100644 apps/server/src/services/nsfw-media.ts
 create mode 100644 packages/stage-pages/src/pages/nsfw/gallery.vue
 create mode 100644 packages/stage-pages/src/pages/nsfw/generate.vue
 create mode 100644 packages/stage-ui/src/stores/nsfw-media.ts

diff --git a/apps/server/docker-compose.yml b/apps/server/docker-compose.yml
index 0435bd6fa5..a1c4c240c7 100644
--- a/apps/server/docker-compose.yml
+++ b/apps/server/docker-compose.yml
@@ -70,6 +70,23 @@ services:
         required: false
     restart: unless-stopped
 
+  nsfw-image-consumer:
+    build:
+      context: ../..
+      dockerfile: apps/server/Dockerfile
+    command: ['pnpm', '-F', '@proj-airi/server', 'run', 'server', 'nsfw-image-consumer']
+    depends_on:
+      db:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    env_file:
+      - path: .env
+        required: false
+      - path: .env.local
+        required: false
+    restart: unless-stopped
+
 volumes:
   db_data:
     driver: local
diff --git a/apps/server/drizzle/0010_nsfw_media.sql b/apps/server/drizzle/0010_nsfw_media.sql
new file mode 100644
index 0000000000..69380e977f
--- /dev/null
+++ b/apps/server/drizzle/0010_nsfw_media.sql
@@ -0,0 +1,36 @@
+CREATE TABLE "image_jobs" (
+  "id" text PRIMARY KEY NOT NULL,
+  "user_id" text NOT NULL,
+  "character_id" text NOT NULL,
+  "route" text NOT NULL,
+  "status" text DEFAULT 'queued' NOT NULL,
+  "prompt" text NOT NULL,
+  "negative_prompt" text NOT NULL,
+  "scene_type" text,
+  "tags" text[] DEFAULT '{}' NOT NULL,
+  "params" jsonb DEFAULT '{}'::jsonb NOT NULL,
+  "result_media_id" text,
+  "error_message" text,
+  "created_at" timestamp DEFAULT now() NOT NULL,
+  "updated_at" timestamp DEFAULT now() NOT NULL
+);
+
+CREATE TABLE "gallery_items" (
+  "id" text PRIMARY KEY NOT NULL,
+  "user_id" text NOT NULL,
+  "character_id" text NOT NULL,
+  "image_job_id" text,
+  "media_id" text,
+  "title" text,
+  "prompt" text NOT NULL,
+  "negative_prompt" text NOT NULL,
+  "scene_type" text,
+  "tags" text[] DEFAULT '{}' NOT NULL,
+  "created_at" timestamp DEFAULT now() NOT NULL,
+  "updated_at" timestamp DEFAULT now() NOT NULL
+);
+
+ALTER TABLE "gallery_items"
+  ADD CONSTRAINT "gallery_items_image_job_id_image_jobs_id_fk"
+  FOREIGN KEY ("image_job_id") REFERENCES "public"."image_jobs"("id")
+  ON DELETE set null ON UPDATE no action;
diff --git a/apps/server/drizzle/meta/_journal.json b/apps/server/drizzle/meta/_journal.json
index bf39c3249f..020689e0b7 100644
--- a/apps/server/drizzle/meta/_journal.json
+++ b/apps/server/drizzle/meta/_journal.json
@@ -71,6 +71,13 @@
       "when": 1774803600000,
       "tag": "0009_nsfw_user_gating",
       "breakpoints": true
+    },
+    {
+      "idx": 10,
+      "version": "7",
+      "when": 1774807200000,
+      "tag": "0010_nsfw_media",
+      "breakpoints": true
     }
   ]
 }
diff --git a/apps/server/package.json b/apps/server/package.json
index b804fd8f88..edce0a65aa 100644
--- a/apps/server/package.json
+++ b/apps/server/package.json
@@ -9,6 +9,7 @@
     "dev": "pnpm run apply:env -- tsx --watch src/bin/run.ts api",
     "start": "pnpm run apply:env -- tsx src/bin/run.ts api",
     "server": "pnpm run apply:env -- tsx src/bin/run.ts",
+    "nsfw:image-consumer": "pnpm run apply:env -- tsx src/bin/run.ts nsfw-image-consumer",
     "build": "tsc -b",
     "typecheck": "tsc --noEmit",
     "db:generate": "drizzle-kit generate",
diff --git a/apps/server/src/app.ts b/apps/server/src/app.ts
index ce46b20487..a37296e169 100644
--- a/apps/server/src/app.ts
+++ b/apps/server/src/app.ts
@@ -12,6 +12,8 @@ import type { FluxService } from './services/flux'
 import type { FluxTransactionService } from './services/flux-transaction'
 import type { Database } from './libs/db'
 import type { ProviderService } from './services/providers'
+import type { NsfwMediaService } from './services/nsfw-media'
+import type { NsfwImageEvent } from './services/nsfw-image-events'
 import type { StripeService } from './services/stripe'
 import type { HonoEnv } from './types/hono'
 
@@ -41,9 +43,11 @@ import { createChatRoutes } from './routes/chats'
 import { createFluxRoutes } from './routes/flux'
 import { createV1CompletionsRoutes } from './routes/openai/v1'
 import { createProviderRoutes } from './routes/providers'
+import { createNsfwMediaRoutes } from './routes/nsfw-media'
 import { createStripeRoutes } from './routes/stripe'
 import { createUserRoutes } from './routes/users'
 import { createBillingMq } from './services/billing/billing-events'
+import { createNsfwImageMq } from './services/nsfw-image-events'
 import { createBillingService } from './services/billing/billing-service'
 import { createCharacterService } from './services/characters'
 import { createChatService } from './services/chats'
@@ -52,6 +56,7 @@ import { createFluxService } from './services/flux'
 import { createFluxTransactionService } from './services/flux-transaction'
 import { createProviderService } from './services/providers'
 import { createRequestLogService } from './services/request-log'
+import { createNsfwMediaService } from './services/nsfw-media'
 import { createStripeService } from './services/stripe'
 import { ApiError, createInternalError, createUnauthorizedError } from './utils/error'
 import { getTrustedOrigin } from './utils/origin'
@@ -62,11 +67,13 @@ interface AppDeps {
   characterService: CharacterService
   chatService: ChatService
   providerService: ProviderService
+  nsfwMediaService: NsfwMediaService
   fluxService: FluxService
   fluxTransactionService: FluxTransactionService
   stripeService: StripeService
   billingService: BillingService
   billingMq: MqService<BillingEvent>
+  nsfwImageMq: MqService<NsfwImageEvent>
   configKV: ConfigKVService
   redis: Redis
   env: Env
@@ -199,6 +206,11 @@ async function buildApp(deps: AppDeps) {
      */
     .route('/api/v1/users', createUserRoutes(deps.db))
 
+    /**
+     * NSFW media routes.
+     */
+    .route('/api/v1/nsfw', createNsfwMediaRoutes(deps.nsfwMediaService, deps.nsfwImageMq))
+
     /**
      * Chat routes are handled by the chat service.
      */
@@ -329,6 +341,18 @@ export async function createApp() {
     build: ({ dependsOn }) => createProviderService(dependsOn.db),
   })
 
+  const nsfwMediaService = injeca.provide('services:nsfw-media', {
+    dependsOn: { db },
+    build: ({ dependsOn }) => createNsfwMediaService(dependsOn.db),
+  })
+
+  const nsfwImageMq = injeca.provide('services:nsfwImageMq', {
+    dependsOn: { redis, env: parsedEnv },
+    build: ({ dependsOn }) => createNsfwImageMq(dependsOn.redis, {
+      stream: dependsOn.env.NSFW_IMAGE_EVENTS_STREAM,
+    }),
+  })
+
   const chatService = injeca.provide('services:chats', {
     dependsOn: { db, otel },
     build: ({ dependsOn }) => createChatService(dependsOn.db, dependsOn.otel?.engagement),
@@ -366,12 +390,14 @@ export async function createApp() {
     characterService,
     chatService,
     providerService,
+    nsfwMediaService,
     fluxService,
     fluxTransactionService,
     requestLogService,
     stripeService,
     billingService,
     billingMq,
+    nsfwImageMq,
     configKV,
     redis,
     env: parsedEnv,
@@ -382,12 +408,14 @@ export async function createApp() {
     auth: resolved.auth,
     characterService: resolved.characterService,
     chatService: resolved.chatService,
-    providerService: resolved.providerService,
-    fluxService: resolved.fluxService,
+      providerService: resolved.providerService,
+      nsfwMediaService: resolved.nsfwMediaService,
+      fluxService: resolved.fluxService,
     fluxTransactionService: resolved.fluxTransactionService,
     stripeService: resolved.stripeService,
     billingService: resolved.billingService,
     billingMq: resolved.billingMq,
+    nsfwImageMq: resolved.nsfwImageMq,
     configKV: resolved.configKV,
     redis: resolved.redis,
     env: resolved.env,
diff --git a/apps/server/src/bin/run-nsfw-image-consumer.ts b/apps/server/src/bin/run-nsfw-image-consumer.ts
new file mode 100644
index 0000000000..9ef52f89d0
--- /dev/null
+++ b/apps/server/src/bin/run-nsfw-image-consumer.ts
@@ -0,0 +1,94 @@
+import process, { pid } from 'node:process'
+
+import { initLogger, LoggerFormat, LoggerLevel, useLogger } from '@guiiai/logg'
+
+import { createDrizzle, migrateDatabase } from '../libs/db'
+import { parseEnv } from '../libs/env'
+import { initializeExternalDependency } from '../libs/external-dependency'
+import { createMqWorker } from '../libs/mq'
+import { createRedis } from '../libs/redis'
+import { createNsfwImageConsumerHandler } from '../services/nsfw-image-consumer-handler'
+import { createNsfwImageMq } from '../services/nsfw-image-events'
+import { createNsfwMediaService } from '../services/nsfw-media'
+
+export async function runNsfwImageConsumer(): Promise<void> {
+  initLogger(LoggerLevel.Debug, LoggerFormat.Pretty)
+
+  const env = parseEnv(process.env)
+  const logger = useLogger('nsfw-image-consumer').useGlobalConfig()
+  const { db, pool } = await initializeExternalDependency(
+    'Database',
+    logger,
+    async (attempt) => {
+      const connection = createDrizzle(env)
+
+      try {
+        await connection.db.execute('SELECT 1')
+        logger.log(`Connected to database on attempt ${attempt}`)
+        await migrateDatabase(connection.db)
+        logger.log(`Applied schema on attempt ${attempt}`)
+        return connection
+      }
+      catch (error) {
+        await connection.pool.end()
+        throw error
+      }
+    },
+  )
+  const redis = await initializeExternalDependency(
+    'Redis',
+    logger,
+    async (attempt) => {
+      const instance = createRedis(env.REDIS_URL)
+
+      try {
+        await instance.connect()
+        logger.log(`Connected to Redis on attempt ${attempt}`)
+        return instance
+      }
+      catch (error) {
+        instance.disconnect()
+        throw error
+      }
+    },
+  )
+
+  const abortController = new AbortController()
+  const consumer = env.NSFW_IMAGE_EVENTS_CONSUMER_NAME ?? `nsfw-image-consumer-${pid}`
+
+  const shutdown = (signalName: string) => {
+    if (abortController.signal.aborted) {
+      return
+    }
+
+    logger.withFields({ signalName }).log('Stopping NSFW image consumer')
+    abortController.abort()
+  }
+
+  process.once('SIGINT', () => shutdown('SIGINT'))
+  process.once('SIGTERM', () => shutdown('SIGTERM'))
+
+  try {
+    const mq = createNsfwImageMq(redis, {
+      stream: env.NSFW_IMAGE_EVENTS_STREAM,
+    })
+
+    const mediaService = createNsfwMediaService(db)
+    const handler = createNsfwImageConsumerHandler(mediaService, env)
+    const worker = createMqWorker(mq)
+
+    await worker.run({
+      group: 'nsfw-image-consumer',
+      consumer,
+      signal: abortController.signal,
+      batchSize: env.NSFW_IMAGE_EVENTS_BATCH_SIZE,
+      blockMs: env.NSFW_IMAGE_EVENTS_BLOCK_MS,
+      minIdleTimeMs: env.NSFW_IMAGE_EVENTS_MIN_IDLE_MS,
+      onMessage: message => handler.handleMessage(message.event),
+    })
+  }
+  finally {
+    await redis.quit()
+    await pool.end()
+  }
+}
diff --git a/apps/server/src/bin/run.ts b/apps/server/src/bin/run.ts
index 1df3d434bf..781206150f 100644
--- a/apps/server/src/bin/run.ts
+++ b/apps/server/src/bin/run.ts
@@ -9,8 +9,9 @@ import { cac } from 'cac'
 import { runApiServer } from '../app'
 import { errorMessageFromUnknown } from '../utils/error-message'
 import { runBillingConsumer } from './run-billing-consumer'
+import { runNsfwImageConsumer } from './run-nsfw-image-consumer'
 
-const serverRoles = ['api', 'billing-consumer'] as const
+const serverRoles = ['api', 'billing-consumer', 'nsfw-image-consumer'] as const
 
 type ServerRole = typeof serverRoles[number]
 
@@ -21,6 +22,9 @@ async function runServerRole(role: ServerRole): Promise<void> {
       return
     case 'billing-consumer':
       await runBillingConsumer()
+      return
+    case 'nsfw-image-consumer':
+      await runNsfwImageConsumer()
   }
 }
 
@@ -36,6 +40,10 @@ export function createServerCli() {
     .command('billing-consumer', 'Start the billing events consumer (transactions, audit, request logs)')
     .action(() => runServerRole('billing-consumer'))
 
+  cli
+    .command('nsfw-image-consumer', 'Start the NSFW image jobs consumer (ComfyUI execution and reconciliation)')
+    .action(() => runServerRole('nsfw-image-consumer'))
+
   cli.help()
 
   return cli
diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index 2d827154e9..973e7d4b54 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -6,7 +6,7 @@ import { useLogger } from '@guiiai/logg'
 import { injeca } from 'injeca'
 import { integer, maxValue, minValue, nonEmpty, object, optional, parse, pipe, string, transform } from 'valibot'
 
-import { DEFAULT_BILLING_EVENTS_STREAM } from '../utils/redis-keys'
+import { DEFAULT_BILLING_EVENTS_STREAM, DEFAULT_NSFW_IMAGE_EVENTS_STREAM } from '../utils/redis-keys'
 
 function optionalIntegerFromString(defaultValue: number, envKey: string, minimum: number) {
   return optional(
@@ -57,6 +57,13 @@ const EnvSchema = object({
   BILLING_EVENTS_BLOCK_MS: optionalIntegerFromString(5000, 'BILLING_EVENTS_BLOCK_MS', 1),
   BILLING_EVENTS_MIN_IDLE_MS: optionalIntegerFromString(30000, 'BILLING_EVENTS_MIN_IDLE_MS', 1),
 
+  NSFW_IMAGE_EVENTS_STREAM: optional(string(), DEFAULT_NSFW_IMAGE_EVENTS_STREAM),
+  NSFW_IMAGE_EVENTS_CONSUMER_NAME: optional(string()),
+  NSFW_IMAGE_EVENTS_BATCH_SIZE: optionalIntegerFromString(10, 'NSFW_IMAGE_EVENTS_BATCH_SIZE', 1),
+  NSFW_IMAGE_EVENTS_BLOCK_MS: optionalIntegerFromString(5000, 'NSFW_IMAGE_EVENTS_BLOCK_MS', 1),
+  NSFW_IMAGE_EVENTS_MIN_IDLE_MS: optionalIntegerFromString(30000, 'NSFW_IMAGE_EVENTS_MIN_IDLE_MS', 1),
+  COMFYUI_BASE_URL: optional(string(), 'http://127.0.0.1:8188'),
+
   // Database pool
   DB_POOL_MAX: optionalIntegerFromString(20, 'DB_POOL_MAX', 1),
   DB_POOL_IDLE_TIMEOUT_MS: optionalIntegerFromString(30000, 'DB_POOL_IDLE_TIMEOUT_MS', 1),
diff --git a/apps/server/src/routes/nsfw-media/index.ts b/apps/server/src/routes/nsfw-media/index.ts
new file mode 100644
index 0000000000..9681200428
--- /dev/null
+++ b/apps/server/src/routes/nsfw-media/index.ts
@@ -0,0 +1,70 @@
+import type { NsfwMediaService } from '../../services/nsfw-media'
+import type { MqService } from '../../libs/mq'
+import type { NsfwImageEvent } from '../../services/nsfw-image-events'
+import type { HonoEnv } from '../../types/hono'
+
+import { Hono } from 'hono'
+import { safeParse } from 'valibot'
+
+import { authGuard } from '../../middlewares/auth'
+import { nanoid } from '../../utils/id'
+import { createBadRequestError } from '../../utils/error'
+import { createNsfwImageRequestedEvent } from '../../services/nsfw-image-events'
+import { CreateGalleryItemSchema, CreateImageJobSchema } from './schema'
+
+export function createNsfwMediaRoutes(mediaService: NsfwMediaService, nsfwImageMq?: MqService<NsfwImageEvent>) {
+  return new Hono<HonoEnv>()
+    .use('*', authGuard)
+    .get('/jobs', async (c) => {
+      const user = c.get('user')!
+      const jobs = await mediaService.listImageJobs(user.id, 'nsfw')
+      return c.json({ jobs })
+    })
+    .post('/jobs', async (c) => {
+      const user = c.get('user')!
+      const body = await c.req.json()
+      const result = safeParse(CreateImageJobSchema, body)
+      if (!result.success)
+        throw createBadRequestError('Invalid Request', 'INVALID_REQUEST', result.issues)
+
+      const job = await mediaService.createImageJob({
+        ...result.output,
+        userId: user.id,
+        params: result.output.params ?? {},
+      })
+
+      if (nsfwImageMq) {
+        await nsfwImageMq.publish(createNsfwImageRequestedEvent({
+          eventId: nanoid(),
+          userId: user.id,
+          characterId: job.characterId,
+          jobId: job.id,
+          route: job.route,
+          metadata: {
+            sceneType: job.sceneType,
+            tags: job.tags,
+          },
+        }))
+      }
+
+      return c.json(job, 201)
+    })
+    .get('/gallery', async (c) => {
+      const user = c.get('user')!
+      const items = await mediaService.listGalleryItems(user.id)
+      return c.json({ items })
+    })
+    .post('/gallery', async (c) => {
+      const user = c.get('user')!
+      const body = await c.req.json()
+      const result = safeParse(CreateGalleryItemSchema, body)
+      if (!result.success)
+        throw createBadRequestError('Invalid Request', 'INVALID_REQUEST', result.issues)
+
+      const item = await mediaService.createGalleryItem({
+        ...result.output,
+        userId: user.id,
+      })
+      return c.json(item, 201)
+    })
+}
diff --git a/apps/server/src/routes/nsfw-media/schema.ts b/apps/server/src/routes/nsfw-media/schema.ts
new file mode 100644
index 0000000000..6c9a0d0694
--- /dev/null
+++ b/apps/server/src/routes/nsfw-media/schema.ts
@@ -0,0 +1,22 @@
+import { array, literal, object, optional, record, string, union, unknown } from 'valibot'
+
+export const CreateImageJobSchema = object({
+  characterId: string(),
+  route: union([literal('normal'), literal('nsfw')]),
+  prompt: string(),
+  negativePrompt: string(),
+  sceneType: optional(string()),
+  tags: array(string()),
+  params: optional(record(string(), unknown())),
+})
+
+export const CreateGalleryItemSchema = object({
+  characterId: string(),
+  imageJobId: optional(string()),
+  mediaId: optional(string()),
+  title: optional(string()),
+  prompt: string(),
+  negativePrompt: string(),
+  sceneType: optional(string()),
+  tags: array(string()),
+})
diff --git a/apps/server/src/schemas/index.ts b/apps/server/src/schemas/index.ts
index 4a0090f7b1..519ad44682 100644
--- a/apps/server/src/schemas/index.ts
+++ b/apps/server/src/schemas/index.ts
@@ -4,6 +4,7 @@ export * from './chats'
 export * from './flux'
 export * from './flux-transaction'
 export * from './llm-request-log'
+export * from './nsfw-media'
 export * from './providers'
 export * from './stripe'
 export * from './user-character'
diff --git a/apps/server/src/schemas/nsfw-media.ts b/apps/server/src/schemas/nsfw-media.ts
new file mode 100644
index 0000000000..4ea53d3f2a
--- /dev/null
+++ b/apps/server/src/schemas/nsfw-media.ts
@@ -0,0 +1,50 @@
+import type { InferInsertModel, InferSelectModel } from 'drizzle-orm'
+
+import { integer, jsonb, pgTable, text, timestamp } from 'drizzle-orm/pg-core'
+
+import { nanoid } from '../utils/id'
+
+export type ImageJobStatus = 'queued' | 'submitting' | 'running' | 'done' | 'failed'
+
+export const imageJobs = pgTable(
+  'image_jobs',
+  {
+    id: text('id').primaryKey().$defaultFn(() => nanoid()),
+    userId: text('user_id').notNull(),
+    characterId: text('character_id').notNull(),
+    route: text('route').notNull().$type<'normal' | 'nsfw'>(),
+    status: text('status').notNull().$type<ImageJobStatus>().default('queued'),
+    prompt: text('prompt').notNull(),
+    negativePrompt: text('negative_prompt').notNull(),
+    sceneType: text('scene_type'),
+    tags: text('tags').array().notNull().default([]),
+    params: jsonb('params').$type<Record<string, unknown>>().notNull().default({}),
+    resultMediaId: text('result_media_id'),
+    errorMessage: text('error_message'),
+    createdAt: timestamp('created_at').defaultNow().notNull(),
+    updatedAt: timestamp('updated_at').defaultNow().notNull(),
+  },
+)
+
+export const galleryItems = pgTable(
+  'gallery_items',
+  {
+    id: text('id').primaryKey().$defaultFn(() => nanoid()),
+    userId: text('user_id').notNull(),
+    characterId: text('character_id').notNull(),
+    imageJobId: text('image_job_id').references(() => imageJobs.id, { onDelete: 'set null' }),
+    mediaId: text('media_id'),
+    title: text('title'),
+    prompt: text('prompt').notNull(),
+    negativePrompt: text('negative_prompt').notNull(),
+    sceneType: text('scene_type'),
+    tags: text('tags').array().notNull().default([]),
+    createdAt: timestamp('created_at').defaultNow().notNull(),
+    updatedAt: timestamp('updated_at').defaultNow().notNull(),
+  },
+)
+
+export type ImageJob = InferSelectModel<typeof imageJobs>
+export type NewImageJob = InferInsertModel<typeof imageJobs>
+export type GalleryItem = InferSelectModel<typeof galleryItems>
+export type NewGalleryItem = InferInsertModel<typeof galleryItems>
diff --git a/apps/server/src/services/nsfw-image-consumer-handler.ts b/apps/server/src/services/nsfw-image-consumer-handler.ts
new file mode 100644
index 0000000000..2572b38379
--- /dev/null
+++ b/apps/server/src/services/nsfw-image-consumer-handler.ts
@@ -0,0 +1,207 @@
+import type { Env } from '../libs/env'
+import type { NsfwMediaService } from './nsfw-media'
+import type { NsfwImageEvent } from './nsfw-image-events'
+
+import { useLogger } from '@guiiai/logg'
+
+const logger = useLogger('nsfw-image-consumer').useGlobalConfig()
+
+interface ComfyUiPromptSubmission {
+  prompt_id?: string
+  number?: number
+  node_errors?: Record<string, unknown>
+}
+
+interface ComfyUiHistoryResponse {
+  [promptId: string]: {
+    outputs?: Record<string, {
+      images?: Array<{
+        filename: string
+        subfolder?: string
+        type?: string
+      }>
+    }>
+    status?: {
+      status_str?: string
+      completed?: boolean
+      messages?: unknown[]
+    }
+  }
+}
+
+class JobStillRunningError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = 'JobStillRunningError'
+  }
+}
+
+export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, env: Env) {
+  async function fetchComfyHistory(promptId: string) {
+    const response = await fetch(new URL(`/history/${promptId}`, env.COMFYUI_BASE_URL))
+    if (response.status === 404) {
+      return null
+    }
+
+    if (!response.ok) {
+      throw new Error(`ComfyUI history lookup failed with status ${response.status}`)
+    }
+
+    const history = await response.json() as ComfyUiHistoryResponse
+    return history[promptId] ?? null
+  }
+
+  function pickFirstImageFilename(historyEntry: NonNullable<Awaited<ReturnType<typeof fetchComfyHistory>>>) {
+    const outputs = historyEntry.outputs ?? {}
+    for (const output of Object.values(outputs)) {
+      const image = output.images?.[0]
+      if (image?.filename) {
+        return image.subfolder
+          ? `${image.subfolder}/${image.filename}`
+          : image.filename
+      }
+    }
+
+    return null
+  }
+
+  function extractWorkflow(params: Record<string, unknown>) {
+    const workflow = params.workflow
+    return workflow && typeof workflow === 'object' ? workflow as Record<string, unknown> : null
+  }
+
+  function getComfyMeta(params: Record<string, unknown>) {
+    const comfy = params.comfy
+    if (!comfy || typeof comfy !== 'object') {
+      return {}
+    }
+
+    return comfy as Record<string, unknown>
+  }
+
+  return {
+    async handleMessage(event: NsfwImageEvent) {
+      const jobId = event.payload.jobId
+      const job = await mediaService.getImageJob(jobId)
+      if (!job) {
+        logger.withFields({ jobId }).warn('Skipping NSFW image event because the job no longer exists')
+        return
+      }
+
+      if (job.status === 'done' || job.status === 'failed') {
+        return
+      }
+
+      const comfyMeta = getComfyMeta(job.params)
+      const promptId = typeof comfyMeta.promptId === 'string' ? comfyMeta.promptId : job.id
+      const clientId = typeof comfyMeta.clientId === 'string' ? comfyMeta.clientId : `airi-${job.userId}`
+
+      if (job.status === 'running' || job.status === 'submitting') {
+        const history = await fetchComfyHistory(promptId)
+        if (!history) {
+          throw new JobStillRunningError(`ComfyUI job ${promptId} has not produced history yet`)
+        }
+
+        const mediaId = pickFirstImageFilename(history)
+        await mediaService.updateImageJobStatus(jobId, 'done', {
+          resultMediaId: mediaId ?? job.resultMediaId,
+          errorMessage: null,
+          params: {
+            ...job.params,
+            comfy: {
+              ...comfyMeta,
+              promptId,
+              clientId,
+              completedAt: new Date().toISOString(),
+            },
+          },
+        })
+
+        await mediaService.updateGalleryItemByImageJobId(jobId, {
+          mediaId: mediaId ?? undefined,
+          title: job.sceneType ? `${job.sceneType} scene` : undefined,
+        })
+        return
+      }
+
+      const workflow = extractWorkflow(job.params)
+      if (!workflow) {
+        await mediaService.updateImageJobStatus(jobId, 'failed', {
+          errorMessage: 'No ComfyUI API workflow was attached to this job. Add params.workflow before enqueueing execution.',
+        })
+        return
+      }
+
+      await mediaService.updateImageJobStatus(jobId, 'submitting', {
+        errorMessage: null,
+        params: {
+          ...job.params,
+          comfy: {
+            ...comfyMeta,
+            promptId,
+            clientId,
+            submittedAt: new Date().toISOString(),
+          },
+        },
+      })
+
+      const submitResponse = await fetch(new URL('/prompt', env.COMFYUI_BASE_URL), {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({
+          prompt: workflow,
+          prompt_id: promptId,
+          client_id: clientId,
+        }),
+      })
+
+      if (!submitResponse.ok) {
+        const body = await submitResponse.text()
+        await mediaService.updateImageJobStatus(jobId, 'failed', {
+          errorMessage: `ComfyUI submit failed with status ${submitResponse.status}: ${body}`.slice(0, 2000),
+        })
+        return
+      }
+
+      const submission = await submitResponse.json() as ComfyUiPromptSubmission
+      await mediaService.updateImageJobStatus(jobId, 'running', {
+        params: {
+          ...job.params,
+          comfy: {
+            ...comfyMeta,
+            promptId: submission.prompt_id ?? promptId,
+            clientId,
+            queueNumber: submission.number,
+            nodeErrors: submission.node_errors,
+            submittedAt: new Date().toISOString(),
+          },
+        },
+      })
+
+      const history = await fetchComfyHistory(promptId)
+      if (!history) {
+        throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
+      }
+
+      const mediaId = pickFirstImageFilename(history)
+      await mediaService.updateImageJobStatus(jobId, 'done', {
+        resultMediaId: mediaId ?? job.resultMediaId,
+        params: {
+          ...job.params,
+          comfy: {
+            ...comfyMeta,
+            promptId,
+            clientId,
+            completedAt: new Date().toISOString(),
+          },
+        },
+      })
+      await mediaService.updateGalleryItemByImageJobId(jobId, {
+        mediaId: mediaId ?? undefined,
+        title: job.sceneType ? `${job.sceneType} scene` : undefined,
+      })
+    },
+  }
+}
+
+export type NsfwImageConsumerHandler = ReturnType<typeof createNsfwImageConsumerHandler>
diff --git a/apps/server/src/services/nsfw-image-events.ts b/apps/server/src/services/nsfw-image-events.ts
new file mode 100644
index 0000000000..ca73a21fb4
--- /dev/null
+++ b/apps/server/src/services/nsfw-image-events.ts
@@ -0,0 +1,117 @@
+import type { InferOutput } from 'valibot'
+
+import type { RedisCommandClient } from '../libs/mq'
+
+import {
+  literal,
+  nonEmpty,
+  number,
+  object,
+  optional,
+  parse,
+  pipe,
+  string,
+  unknown,
+} from 'valibot'
+
+import { createMqService } from '../libs/mq'
+import { DEFAULT_NSFW_IMAGE_EVENTS_STREAM } from '../utils/redis-keys'
+
+const NsfwImageEventTypeSchema = literal('nsfw.image.requested')
+
+const NsfwImageRequestedPayloadSchema = object({
+  jobId: pipe(string(), nonEmpty()),
+  route: pipe(string(), nonEmpty()),
+  metadata: optional(unknown()),
+})
+
+const NsfwImageEventEnvelopeSchema = object({
+  eventId: pipe(string(), nonEmpty()),
+  eventType: NsfwImageEventTypeSchema,
+  aggregateId: pipe(string(), nonEmpty()),
+  userId: pipe(string(), nonEmpty()),
+  characterId: pipe(string(), nonEmpty()),
+  occurredAt: pipe(string(), nonEmpty()),
+  schemaVersion: number(),
+  payload: unknown(),
+})
+
+type NsfwImageEventEnvelope = InferOutput<typeof NsfwImageEventEnvelopeSchema>
+type NsfwImageRequestedPayload = InferOutput<typeof NsfwImageRequestedPayloadSchema>
+
+export type NsfwImageRequestedEvent = NsfwImageEventEnvelope & {
+  eventType: 'nsfw.image.requested'
+  payload: NsfwImageRequestedPayload
+}
+
+export type NsfwImageEvent = NsfwImageRequestedEvent
+
+export function serializeNsfwImageEvent(event: NsfwImageEvent) {
+  return {
+    event_id: event.eventId,
+    event_type: event.eventType,
+    aggregate_id: event.aggregateId,
+    user_id: event.userId,
+    character_id: event.characterId,
+    occurred_at: event.occurredAt,
+    schema_version: String(event.schemaVersion),
+    payload: JSON.stringify(event.payload),
+  }
+}
+
+export function parseNsfwImageEvent(fields: Record<string, string | undefined>): NsfwImageEvent {
+  const payload = fields.payload
+  if (payload == null) {
+    throw new TypeError('NSFW image event payload is required')
+  }
+
+  const parsedEnvelope = parse(NsfwImageEventEnvelopeSchema, {
+    eventId: fields.event_id,
+    eventType: fields.event_type,
+    aggregateId: fields.aggregate_id,
+    userId: fields.user_id,
+    characterId: fields.character_id,
+    occurredAt: fields.occurred_at,
+    schemaVersion: Number(fields.schema_version),
+    payload: JSON.parse(payload),
+  })
+
+  return {
+    ...parsedEnvelope,
+    eventType: 'nsfw.image.requested',
+    payload: parse(NsfwImageRequestedPayloadSchema, parsedEnvelope.payload),
+  }
+}
+
+export function createNsfwImageMq(redis: RedisCommandClient, options: { stream?: string, maxLength?: number } = {}) {
+  return createMqService<NsfwImageEvent>(redis, {
+    stream: options.stream ?? DEFAULT_NSFW_IMAGE_EVENTS_STREAM,
+    maxLength: options.maxLength,
+    serialize: serializeNsfwImageEvent,
+    deserialize: parseNsfwImageEvent,
+  })
+}
+
+export function createNsfwImageRequestedEvent(input: {
+  eventId: string
+  userId: string
+  characterId: string
+  jobId: string
+  route: 'normal' | 'nsfw'
+  metadata?: unknown
+}) {
+  return {
+    eventId: input.eventId,
+    eventType: 'nsfw.image.requested' as const,
+    aggregateId: input.jobId,
+    userId: input.userId,
+    characterId: input.characterId,
+    occurredAt: new Date().toISOString(),
+    schemaVersion: 1,
+    payload: {
+      jobId: input.jobId,
+      route: input.route,
+      metadata: input.metadata,
+    },
+  }
+}
diff --git a/apps/server/src/services/nsfw-media.ts b/apps/server/src/services/nsfw-media.ts
new file mode 100644
index 0000000000..cf18c4adb9
--- /dev/null
+++ b/apps/server/src/services/nsfw-media.ts
@@ -0,0 +1,76 @@
+import type { Database } from '../libs/db'
+import type { ImageJobStatus } from '../schemas/nsfw-media'
+
+import { and, desc, eq } from 'drizzle-orm'
+
+import * as schema from '../schemas/nsfw-media'
+
+export function createNsfwMediaService(db: Database) {
+  return {
+    async createImageJob(data: schema.NewImageJob) {
+      const [job] = await db.insert(schema.imageJobs).values(data).returning()
+      return job
+    },
+
+    async listImageJobs(userId: string, route: 'normal' | 'nsfw' = 'nsfw') {
+      return await db.query.imageJobs.findMany({
+        where: and(
+          eq(schema.imageJobs.userId, userId),
+          eq(schema.imageJobs.route, route),
+        ),
+        orderBy: desc(schema.imageJobs.createdAt),
+      })
+    },
+
+    async getImageJob(jobId: string) {
+      return await db.query.imageJobs.findFirst({
+        where: eq(schema.imageJobs.id, jobId),
+      })
+    },
+
+    async updateImageJob(jobId: string, data: Partial<schema.NewImageJob>) {
+      const [job] = await db
+        .update(schema.imageJobs)
+        .set({
+          ...data,
+          updatedAt: new Date(),
+        })
+        .where(eq(schema.imageJobs.id, jobId))
+        .returning()
+      return job
+    },
+
+    async updateImageJobStatus(jobId: string, status: ImageJobStatus, data: Partial<schema.NewImageJob> = {}) {
+      return await this.updateImageJob(jobId, {
+        ...data,
+        status,
+      })
+    },
+
+    async createGalleryItem(data: schema.NewGalleryItem) {
+      const [item] = await db.insert(schema.galleryItems).values(data).returning()
+      return item
+    },
+
+    async listGalleryItems(userId: string) {
+      return await db.query.galleryItems.findMany({
+        where: eq(schema.galleryItems.userId, userId),
+        orderBy: desc(schema.galleryItems.createdAt),
+      })
+    },
+
+    async updateGalleryItemByImageJobId(imageJobId: string, data: Partial<schema.NewGalleryItem>) {
+      const [item] = await db
+        .update(schema.galleryItems)
+        .set({
+          ...data,
+          updatedAt: new Date(),
+        })
+        .where(eq(schema.galleryItems.imageJobId, imageJobId))
+        .returning()
+      return item
+    },
+  }
+}
+
+export type NsfwMediaService = ReturnType<typeof createNsfwMediaService>
diff --git a/apps/server/src/utils/redis-keys.ts b/apps/server/src/utils/redis-keys.ts
index 7d822383d8..0685cc908d 100644
--- a/apps/server/src/utils/redis-keys.ts
+++ b/apps/server/src/utils/redis-keys.ts
@@ -16,6 +16,7 @@ export function createRedisKey(...parts: RedisKeyPart[]): string {
 }
 
 export const DEFAULT_BILLING_EVENTS_STREAM = createRedisKey('billing', 'events')
+export const DEFAULT_NSFW_IMAGE_EVENTS_STREAM = createRedisKey('nsfw', 'image', 'events')
 
 export function configRedisKey(key: string): string {
   return createRedisKey('config', key)
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 548912f7f8..ed26fc9d1d 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -38,14 +38,16 @@ Role:
 - `packages/server-schema/src/index.ts`
   - schema exports
 - `packages/server-sdk-shared/src/index.ts`
-  - shared invoke contract name `hermes:generate-reply`
+  - shared invoke contract names `hermes:generate-reply` and `hermes:generate-image-prompt`
 
 ### Chat and Hermes Transport
 
 - `packages/stage-ui/src/libs/hermes.ts`
   - converts AIRI session data into Hermes request payloads
+  - builds NSFW image prompt requests
 - `packages/stage-ui/src/libs/hermes-transport.ts`
   - HTTP transport helper and local stub fallback
+  - includes NSFW image prompt transport
 - `packages/stage-ui/src/libs/server.ts`
   - `HERMES_URL`
   - `USE_HERMES_CHAT`
@@ -57,6 +59,9 @@ Role:
 - `packages/stage-ui/src/stores/chat/hermes-memory-store.ts`
   - per-session local persistence for summaries and facts
   - stores route, scene type, judge score, and judge flags
+- `packages/stage-ui/src/stores/nsfw-media.ts`
+  - calls `/api/v1/nsfw/jobs` and `/api/v1/nsfw/gallery`
+  - stores server-backed NSFW image job and gallery records
 
 ### Auth and User Gating
 
@@ -110,11 +115,41 @@ Role:
   - includes character-level NSFW editor
 - `packages/stage-pages/src/pages/nsfw/[id].vue`
   - separate NSFW detail page
+- `packages/stage-pages/src/pages/nsfw/generate.vue`
+  - plans NSFW image prompts through Hermes and writes server-backed jobs/gallery items
+  - accepts an optional real ComfyUI API workflow JSON payload for actual execution
+- `packages/stage-pages/src/pages/nsfw/gallery.vue`
+  - displays server-backed NSFW gallery records
 - `apps/stage-web/src/pages/settings/characters/components/CharacterDialog.vue`
   - general creator dialog without direct NSFW clutter
 - `apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue`
   - richer card metadata
 
+### Server-backed NSFW Media
+
+- `apps/server/src/schemas/nsfw-media.ts`
+  - `image_jobs`
+  - `gallery_items`
+- `apps/server/src/services/nsfw-media.ts`
+  - create/list image jobs
+  - create/list gallery items
+  - update image jobs and gallery items during execution lifecycle
+- `apps/server/src/routes/nsfw-media/schema.ts`
+  - request validation for NSFW jobs and gallery items
+- `apps/server/src/routes/nsfw-media/index.ts`
+- `apps/server/src/services/nsfw-image-events.ts`
+  - Redis Stream envelope for durable NSFW image execution requests
+- `apps/server/src/services/nsfw-image-consumer-handler.ts`
+  - ComfyUI submission and `/history/{prompt_id}` reconciliation logic
+- `apps/server/src/bin/run-nsfw-image-consumer.ts`
+  - standalone worker entrypoint for NSFW image execution
+- `apps/server/docker-compose.yml`
+  - now includes `nsfw-image-consumer` alongside `api` and `billing-consumer`
+- `GET/POST /api/v1/nsfw/jobs`
+- `GET/POST /api/v1/nsfw/gallery`
+- `apps/server/drizzle/0010_nsfw_media.sql`
+  - migration for server-backed NSFW media records
+
 ## Hermes Agent File Index
 
 ### Types and Runtime
@@ -149,12 +184,17 @@ Role:
   - builds persona-aware deterministic replies
   - references scenario, speaking style, starter messages, boundaries, memory, and assembled context
   - returns judge flags for thin or mirrored responses
+- `agent/airi_image_prompt_service.py`
+  - plans NSFW image prompts, negative prompts, and tags
+  - enforces user and character gating for image planning
 
 ### HTTP Bridge
 
 - `agent/airi_http_service.py`
   - `GET /health`
   - `POST /v1/airi/generate-reply`
+- `POST /v1/airi/generate-image-prompt`
+- AIRI server now also owns a Redis-backed `nsfw-image-consumer` path for durable ComfyUI execution.
 
 ## Current State
 
@@ -171,14 +211,17 @@ Role:
 - Hermes deterministic reply assembly
 - Hermes memory delta return path into AIRI
 - AIRI-side route resolution for normal vs NSFW Hermes turns
+- Hermes-backed NSFW image prompt planning
+- server-backed NSFW image job and gallery records
+- Redis-backed NSFW image execution queue
+- ComfyUI submit/reconcile worker path
 
 ### Still Open
 
 - server-side long-term memory
 - quality judge beyond simple heuristic flags
-- image prompt generation
-- gallery and generate routes
 - premium gating for NSFW media actions
+- a default real ComfyUI API workflow mapping for generated NSFW prompts
 - actual model wiring to `Hermes-4.3-36B`, `Grok 4.20`, and `GPT-5 mini`
 - build, typecheck, and tests once dependencies are installed
 
diff --git a/docs/content/en/nsfw-companion-todo.md b/docs/content/en/nsfw-companion-todo.md
index fcf6633de0..0792a336e0 100644
--- a/docs/content/en/nsfw-companion-todo.md
+++ b/docs/content/en/nsfw-companion-todo.md
@@ -9,6 +9,11 @@ This is the implementation checklist for the AIRI + Hermes companion stack.
 - [x] Add AIRI request builders for Hermes payloads.
 - [x] Add a real transport bridge from AIRI to Hermes.
 - [x] Add a Hermes `generate-reply` handler using the shared contract shape.
+- [x] Add a Redis-backed NSFW image queue and worker entrypoint in the AIRI server.
+- [x] Publish NSFW image jobs into the queue from `POST /api/v1/nsfw/jobs`.
+- [x] Add a ComfyUI submit/reconcile consumer path that treats AIRI as the source of truth.
+- [ ] Attach a real ComfyUI API workflow payload to `params.workflow` during NSFW image job creation.
+- [ ] Persist ComfyUI execution metadata more explicitly than the current `params.comfy` blob if recovery needs become more complex.
 
 ## AIRI
 
@@ -16,8 +21,8 @@ This is the implementation checklist for the AIRI + Hermes companion stack.
 
 - [x] Finish `/nsfw` as a real management surface, not only discovery.
 - [ ] Add NSFW profile actions and access states.
-- [ ] Add `/nsfw/gallery`.
-- [ ] Add `/nsfw/generate`.
+- [x] Add `/nsfw/gallery`.
+- [x] Add `/nsfw/generate`.
 - [ ] Add premium gating for NSFW actions.
 
 ### Chat
@@ -50,7 +55,7 @@ This is the implementation checklist for the AIRI + Hermes companion stack.
 - [x] Add `context_assembler`.
 - [x] Add `reply_service`.
 - [ ] Add `quality_judge`.
-- [ ] Add `image_prompt_service`.
+- [x] Add `image_prompt_service`.
 - [ ] Add creator/admin copilot flows for AIRI characters.
 
 ## Models
@@ -69,9 +74,9 @@ This is the implementation checklist for the AIRI + Hermes companion stack.
 
 ## Media
 
-- [ ] Add image prompt generation.
-- [ ] Add image job queue.
-- [ ] Add gallery record storage.
+- [x] Add image prompt generation.
+- [x] Add image job queue.
+- [x] Add gallery record storage.
 - [ ] Separate normal and NSFW media policy.
 
 ## Verification
diff --git a/packages/stage-pages/src/pages/nsfw/[id].vue b/packages/stage-pages/src/pages/nsfw/[id].vue
index 6b1673c7b0..dd8de6a54d 100644
--- a/packages/stage-pages/src/pages/nsfw/[id].vue
+++ b/packages/stage-pages/src/pages/nsfw/[id].vue
@@ -144,6 +144,12 @@ async function enterStage() {
               <Button @click="enterStage">
                 Enter Stage
               </Button>
+              <Button variant="ghost" @click="router.push('/nsfw/generate')">
+                Generate Prompt
+              </Button>
+              <Button variant="ghost" @click="router.push('/nsfw/gallery')">
+                Open Gallery
+              </Button>
               <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/settings/characters')">
                 Manage Character
               </Button>
diff --git a/packages/stage-pages/src/pages/nsfw/gallery.vue b/packages/stage-pages/src/pages/nsfw/gallery.vue
new file mode 100644
index 0000000000..a8a6eab6c7
--- /dev/null
+++ b/packages/stage-pages/src/pages/nsfw/gallery.vue
@@ -0,0 +1,139 @@
+<script setup lang="ts">
+import { useAuthStore } from '@proj-airi/stage-ui/stores/auth'
+import { useNsfwMediaStore } from '@proj-airi/stage-ui/stores/nsfw-media'
+import { Button } from '@proj-airi/ui'
+import { computed, onMounted } from 'vue'
+import { useRouter } from 'vue-router'
+
+const router = useRouter()
+const authStore = useAuthStore()
+const mediaStore = useNsfwMediaStore()
+
+const accessDenied = computed(() => !authStore.canAccessNsfw)
+const items = computed(() => mediaStore.sortedGalleryItems)
+
+onMounted(() => {
+  mediaStore.fetchGallery().catch(() => {})
+})
+
+function formatDate(value: number) {
+  return new Date(value).toLocaleString()
+}
+</script>
+
+<template>
+  <div class="min-h-screen px-4 py-8 md:px-8">
+    <div mx-auto max-w-6xl class="space-y-6">
+      <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-amber-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
+        <div class="absolute right--12 top--14 h-60 w-60 rounded-full bg-amber-400/15 blur-3xl" />
+        <div class="absolute bottom--12 left-8 h-48 w-48 rounded-full bg-orange-300/10 blur-3xl" />
+        <div class="relative z-1 max-w-3xl">
+          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.16em] backdrop-blur">
+            NSFW Gallery
+          </div>
+          <h1 class="text-4xl font-semibold leading-tight md:text-5xl">
+            Saved prompt plans and scene packages
+          </h1>
+          <p class="mt-4 max-w-2xl text-sm text-white/75 leading-6 md:text-base">
+            This gallery only shows real prompt plans you saved from the NSFW generate flow. No stock images, no fake cards.
+          </p>
+          <div class="mt-6 flex flex-wrap gap-3">
+            <Button @click="router.push('/nsfw/generate')">
+              Open Generate
+            </Button>
+            <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/nsfw')">
+              Back to NSFW Explore
+            </Button>
+          </div>
+        </div>
+      </section>
+
+      <section v-if="accessDenied" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        <h2 class="text-2xl font-semibold">
+          NSFW gallery is disabled
+        </h2>
+        <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+          This account needs adult verification, sensitive content enabled, and a non-standard content tier before the NSFW gallery is available.
+        </p>
+      </section>
+
+      <section v-else-if="!items.length" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        <h2 class="text-2xl font-semibold">
+          No saved prompt plans yet
+        </h2>
+        <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+          Save a planned prompt from the generate page and it will show up here as a real gallery record.
+        </p>
+        <div class="mt-6 flex justify-center gap-3">
+          <Button @click="router.push('/nsfw/generate')">
+            Open Generate
+          </Button>
+          <Button variant="ghost" @click="router.push('/nsfw')">
+            Back to Explore
+          </Button>
+        </div>
+      </section>
+
+      <section v-else class="grid gap-6 md:grid-cols-2">
+        <article
+          v-for="item in items"
+          :key="item.id"
+          class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800"
+        >
+          <div class="flex items-start justify-between gap-4">
+            <div>
+              <div class="text-xs uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                {{ item.title || item.characterId }}
+              </div>
+              <div class="mt-2 text-lg font-semibold">
+                {{ item.sceneType || 'nsfw' }}
+              </div>
+            </div>
+          </div>
+
+          <div class="mt-4 space-y-4">
+            <div>
+              <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                Prompt
+              </div>
+              <div class="mt-2 rounded-2xl bg-neutral-50 px-4 py-4 text-sm leading-6 dark:bg-neutral-800">
+                {{ item.prompt }}
+              </div>
+            </div>
+
+            <div>
+              <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                Negative Prompt
+              </div>
+              <div class="mt-2 rounded-2xl bg-neutral-50 px-4 py-4 text-sm leading-6 dark:bg-neutral-800">
+                {{ item.negativePrompt || 'None' }}
+              </div>
+            </div>
+
+            <div class="flex flex-wrap gap-2">
+              <span
+                v-for="tag in item.tags"
+                :key="`${item.id}:${tag}`"
+                class="rounded-full bg-amber-100 px-3 py-1 text-xs font-medium text-amber-700 dark:bg-amber-500/15 dark:text-amber-300"
+              >
+                {{ tag }}
+              </span>
+            </div>
+
+            <div class="text-xs text-neutral-500 dark:text-neutral-400">
+              Saved {{ formatDate(item.createdAt) }}
+            </div>
+          </div>
+        </article>
+      </section>
+    </div>
+  </div>
+</template>
+
+<route lang="yaml">
+meta:
+  title: NSFW Gallery
+  description: Saved NSFW prompt plans for future ComfyUI jobs and gallery records
+  stageTransition:
+    name: slide
+</route>
diff --git a/packages/stage-pages/src/pages/nsfw/generate.vue b/packages/stage-pages/src/pages/nsfw/generate.vue
new file mode 100644
index 0000000000..811591635b
--- /dev/null
+++ b/packages/stage-pages/src/pages/nsfw/generate.vue
@@ -0,0 +1,358 @@
+<script setup lang="ts">
+import { buildHermesImagePromptRequest, createHttpHermesImagePromptTransport, generateHermesImagePromptViaTransport } from '@proj-airi/stage-ui/libs'
+import { useAuthStore } from '@proj-airi/stage-ui/stores/auth'
+import { useCharacterStore } from '@proj-airi/stage-ui/stores/characters'
+import { useNsfwMediaStore } from '@proj-airi/stage-ui/stores/nsfw-media'
+import { Button } from '@proj-airi/ui'
+import { computed, onMounted, reactive, ref, watch } from 'vue'
+import { useRouter } from 'vue-router'
+
+const router = useRouter()
+const authStore = useAuthStore()
+const characterStore = useCharacterStore()
+const nsfwMediaStore = useNsfwMediaStore()
+
+const loading = ref(false)
+const error = ref('')
+const saved = ref(false)
+const selectedCharacterId = ref('')
+const result = ref<null | {
+  prompt: string
+  negativePrompt: string
+  tags: string[]
+  sceneType?: string
+}>(null)
+
+const form = reactive({
+  prompt: '',
+  style: 'cinematic portrait',
+  mood: 'intimate',
+  framing: 'waist-up',
+  aspectRatio: '3:4',
+  comfyWorkflow: '',
+})
+
+onMounted(async () => {
+  await characterStore.fetchList(true)
+
+  if (!selectedCharacterId.value) {
+    const first = Array.from(characterStore.characters.values()).find(char => char.nsfwEnabled && char.nsfwLevel !== 'none')
+    if (first)
+      selectedCharacterId.value = first.id
+  }
+})
+
+const accessDenied = computed(() => !authStore.canAccessNsfw)
+const characters = computed(() => Array.from(characterStore.characters.values())
+  .filter(char => char.nsfwEnabled && char.nsfwLevel !== 'none')
+  .sort((a, b) => Number(b.interactionsCount || 0) - Number(a.interactionsCount || 0)))
+const selectedCharacter = computed(() => selectedCharacterId.value ? characterStore.getCharacter(selectedCharacterId.value) : null)
+const selectedCharacterName = computed(() => selectedCharacter.value?.i18n?.[0]?.name || selectedCharacter.value?.characterId || '')
+
+watch(selectedCharacterId, () => {
+  error.value = ''
+  result.value = null
+  saved.value = false
+})
+
+async function generate() {
+  if (!selectedCharacter.value)
+    return
+
+  loading.value = true
+  error.value = ''
+  saved.value = false
+
+  try {
+    const request = buildHermesImagePromptRequest({
+      user: {
+        id: authStore.userId,
+        adultVerified: authStore.adultVerified,
+        allowSensitiveContent: authStore.allowSensitiveContent,
+        subscriptionTier: authStore.profile?.subscriptionTier ?? 'free',
+        contentTier: authStore.contentTier,
+      },
+      character: selectedCharacter.value,
+      prompt: form.prompt,
+      style: form.style,
+      mood: form.mood,
+      framing: form.framing,
+      aspectRatio: form.aspectRatio,
+      route: 'nsfw',
+    })
+
+    const response = await generateHermesImagePromptViaTransport(request, createHttpHermesImagePromptTransport())
+    result.value = {
+      prompt: response.prompt,
+      negativePrompt: response.negativePrompt,
+      tags: response.tags,
+      sceneType: response.sceneType,
+    }
+  }
+  catch (err) {
+    error.value = err instanceof Error ? err.message : 'Failed to generate image prompt'
+  }
+  finally {
+    loading.value = false
+  }
+}
+
+async function saveToGallery() {
+  if (!selectedCharacter.value || !result.value)
+    return
+
+  error.value = ''
+
+  try {
+    let workflow: Record<string, unknown> | undefined
+    if (form.comfyWorkflow.trim()) {
+      const parsed = JSON.parse(form.comfyWorkflow) as unknown
+      if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('ComfyUI workflow must be a JSON object in API prompt format')
+      }
+      workflow = parsed as Record<string, unknown>
+    }
+
+    const job = await nsfwMediaStore.createJob({
+      characterId: selectedCharacter.value.id,
+      route: 'nsfw',
+      prompt: result.value.prompt,
+      negativePrompt: result.value.negativePrompt,
+      sceneType: result.value.sceneType,
+      tags: result.value.tags,
+      params: workflow
+        ? {
+            workflow,
+            planner: {
+              style: form.style,
+              mood: form.mood,
+              framing: form.framing,
+              aspectRatio: form.aspectRatio,
+            },
+          }
+        : {
+            planner: {
+              style: form.style,
+              mood: form.mood,
+              framing: form.framing,
+              aspectRatio: form.aspectRatio,
+            },
+          },
+    })
+
+    await nsfwMediaStore.createGalleryItem({
+      characterId: selectedCharacter.value.id,
+      imageJobId: job.id,
+      title: `${selectedCharacterName.value} · ${result.value.sceneType || 'nsfw'}`,
+      prompt: result.value.prompt,
+      negativePrompt: result.value.negativePrompt,
+      sceneType: result.value.sceneType,
+      tags: result.value.tags,
+    })
+
+    saved.value = true
+  }
+  catch (err) {
+    error.value = err instanceof Error ? err.message : 'Failed to save NSFW gallery item'
+  }
+}
+</script>
+
+<template>
+  <div class="min-h-screen px-4 py-8 md:px-8">
+    <div mx-auto max-w-6xl class="space-y-6">
+      <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-fuchsia-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
+        <div class="absolute right--12 top--14 h-60 w-60 rounded-full bg-fuchsia-400/15 blur-3xl" />
+        <div class="absolute bottom--12 left-8 h-48 w-48 rounded-full bg-rose-300/10 blur-3xl" />
+        <div class="relative z-1 max-w-3xl">
+          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.16em] backdrop-blur">
+            NSFW Generate
+          </div>
+          <h1 class="text-4xl font-semibold leading-tight md:text-5xl">
+            Build image prompts for explicit companions
+          </h1>
+          <p class="mt-4 max-w-2xl text-sm text-white/75 leading-6 md:text-base">
+            Hermes plans the prompt, negative prompt, and tags from your character persona, relationship mode, and NSFW gating rules before anything goes to ComfyUI.
+          </p>
+          <div class="mt-6 flex flex-wrap gap-3">
+            <Button @click="router.push('/nsfw')">
+              Back to NSFW Explore
+            </Button>
+            <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/nsfw/gallery')">
+              Open Gallery
+            </Button>
+            <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/settings/account')">
+              Account Access
+            </Button>
+          </div>
+        </div>
+      </section>
+
+      <section v-if="accessDenied" class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+        <h2 class="text-2xl font-semibold">
+          NSFW image generation is disabled
+        </h2>
+        <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+          This account needs adult verification, sensitive content enabled, and a non-standard content tier before NSFW image planning is available.
+        </p>
+      </section>
+
+      <template v-else>
+        <section class="grid gap-6 lg:grid-cols-[0.95fr,1.05fr]">
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Planner Input
+            </h2>
+
+            <div class="mt-4 space-y-4">
+              <div class="flex flex-col gap-1.5">
+                <label class="text-sm font-medium">Character</label>
+                <select v-model="selectedCharacterId" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                  <option value="" disabled>
+                    Select a character
+                  </option>
+                  <option v-for="character in characters" :key="character.id" :value="character.id">
+                    {{ character.i18n?.[0]?.name || character.characterId }} · {{ character.nsfwLevel }}
+                  </option>
+                </select>
+              </div>
+
+              <div class="flex flex-col gap-1.5">
+                <label class="text-sm font-medium">Scene Prompt</label>
+                <textarea
+                  v-model="form.prompt"
+                  rows="6"
+                  class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800"
+                  placeholder="Describe the shot you want, the pose, outfit, setting, or scene beat."
+                />
+              </div>
+
+              <div class="grid gap-4 sm:grid-cols-2">
+                <div class="flex flex-col gap-1.5">
+                  <label class="text-sm font-medium">Style</label>
+                  <input v-model="form.style" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                </div>
+
+                <div class="flex flex-col gap-1.5">
+                  <label class="text-sm font-medium">Mood</label>
+                  <input v-model="form.mood" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                </div>
+              </div>
+
+              <div class="grid gap-4 sm:grid-cols-2">
+                <div class="flex flex-col gap-1.5">
+                  <label class="text-sm font-medium">Framing</label>
+                  <input v-model="form.framing" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                </div>
+
+                <div class="flex flex-col gap-1.5">
+                  <label class="text-sm font-medium">Aspect Ratio</label>
+                  <input v-model="form.aspectRatio" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                </div>
+              </div>
+
+              <div class="flex flex-col gap-1.5">
+                <label class="text-sm font-medium">ComfyUI API Workflow JSON</label>
+                <textarea
+                  v-model="form.comfyWorkflow"
+                  rows="7"
+                  class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 font-mono text-xs outline-none dark:border-neutral-700 dark:bg-neutral-800"
+                />
+                <p class="text-xs text-neutral-500 leading-5 dark:text-neutral-400">
+                  Optional, but required for actual ComfyUI execution. Paste a real API-format workflow object here if you want the queued job to run instead of only being planned and stored.
+                </p>
+              </div>
+
+              <div class="flex items-center gap-3">
+                <Button :disabled="loading || !selectedCharacter || !form.prompt.trim()" @click="generate">
+                  {{ loading ? 'Planning...' : 'Generate Image Prompt' }}
+                </Button>
+                <span v-if="selectedCharacterName" class="text-xs text-neutral-500 dark:text-neutral-400">
+                  Active: {{ selectedCharacterName }}
+                </span>
+                <span v-if="saved" class="text-xs text-emerald-600 dark:text-emerald-400">
+                  Saved to gallery
+                </span>
+              </div>
+
+              <p v-if="error" class="text-sm text-rose-600 dark:text-rose-400">
+                {{ error }}
+              </p>
+            </div>
+          </div>
+
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Planned Prompt
+            </h2>
+
+            <div v-if="result" class="mt-4 space-y-5">
+              <div>
+                <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                  Scene Type
+                </div>
+                <div class="mt-1 text-sm font-medium">
+                  {{ result.sceneType || 'nsfw' }}
+                </div>
+              </div>
+
+              <div>
+                <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                  Prompt
+                </div>
+                <div class="mt-2 rounded-2xl bg-neutral-50 px-4 py-4 text-sm leading-6 dark:bg-neutral-800">
+                  {{ result.prompt }}
+                </div>
+              </div>
+
+              <div>
+                <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                  Negative Prompt
+                </div>
+                <div class="mt-2 rounded-2xl bg-neutral-50 px-4 py-4 text-sm leading-6 dark:bg-neutral-800">
+                  {{ result.negativePrompt || 'None' }}
+                </div>
+              </div>
+
+              <div>
+                <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                  Tags
+                </div>
+                <div class="mt-3 flex flex-wrap gap-2">
+                  <span
+                    v-for="tag in result.tags"
+                    :key="tag"
+                    class="rounded-full bg-fuchsia-100 px-3 py-1 text-xs font-medium text-fuchsia-700 dark:bg-fuchsia-500/15 dark:text-fuchsia-300"
+                  >
+                    {{ tag }}
+                  </span>
+                </div>
+              </div>
+
+              <div class="flex items-center gap-3">
+                <Button @click="saveToGallery">
+                  Save To Gallery
+                </Button>
+                <Button variant="ghost" @click="router.push('/nsfw/gallery')">
+                  Open Gallery
+                </Button>
+              </div>
+            </div>
+
+            <div v-else class="mt-4 rounded-2xl border border-dashed border-neutral-200 px-5 py-10 text-sm text-neutral-500 dark:border-neutral-700 dark:text-neutral-400">
+              Generate a prompt to see the final scene package Hermes would send toward your image pipeline.
+            </div>
+          </div>
+        </section>
+      </template>
+    </div>
+  </div>
+</template>
+
+<route lang="yaml">
+meta:
+  title: NSFW Generate
+  description: Plan NSFW image prompts through Hermes before sending them to media generation
+  stageTransition:
+    name: slide
+</route>
diff --git a/packages/stage-pages/src/pages/nsfw/index.vue b/packages/stage-pages/src/pages/nsfw/index.vue
index e804961879..5c7edc219d 100644
--- a/packages/stage-pages/src/pages/nsfw/index.vue
+++ b/packages/stage-pages/src/pages/nsfw/index.vue
@@ -277,6 +277,12 @@ async function saveSelectedCharacter() {
             <Button @click="router.push('/v2')">
               Open Normal Explore
             </Button>
+            <Button variant="ghost" @click="router.push('/nsfw/generate')">
+              Open Generate
+            </Button>
+            <Button variant="ghost" @click="router.push('/nsfw/gallery')">
+              Open Gallery
+            </Button>
             <Button variant="ghost" @click="router.push('/settings/characters')">
               Edit Character Flags
             </Button>
@@ -449,6 +455,9 @@ async function saveSelectedCharacter() {
               <Button @click="openCharacter(featuredCharacter.id)">
                 Open Profile
               </Button>
+              <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/nsfw/generate')">
+                Generate Prompt
+              </Button>
               <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="characterStore.activateCharacter(featuredCharacter.id)">
                 Activate Only
               </Button>
diff --git a/packages/stage-ui/src/stores/nsfw-media.ts b/packages/stage-ui/src/stores/nsfw-media.ts
new file mode 100644
index 0000000000..01b27d5b7b
--- /dev/null
+++ b/packages/stage-ui/src/stores/nsfw-media.ts
@@ -0,0 +1,130 @@
+import { defineStore } from 'pinia'
+import { computed, ref } from 'vue'
+
+import { client } from '../composables/api'
+
+export interface NsfwImageJob {
+  id: string
+  userId: string
+  characterId: string
+  route: 'normal' | 'nsfw'
+  status: 'queued' | 'submitting' | 'running' | 'done' | 'failed'
+  prompt: string
+  negativePrompt: string
+  sceneType?: string | null
+  tags: string[]
+  params: Record<string, unknown>
+  resultMediaId?: string | null
+  errorMessage?: string | null
+  createdAt: string | number | Date
+  updatedAt: string | number | Date
+}
+
+export interface NsfwGalleryItem {
+  id: string
+  userId: string
+  characterId: string
+  imageJobId?: string | null
+  mediaId?: string | null
+  title?: string | null
+  prompt: string
+  negativePrompt: string
+  sceneType?: string | null
+  tags: string[]
+  createdAt: string | number | Date
+  updatedAt: string | number | Date
+}
+
+export const useNsfwMediaStore = defineStore('nsfw-media', () => {
+  const jobs = ref<NsfwImageJob[]>([])
+  const galleryItems = ref<NsfwGalleryItem[]>([])
+  const loadingJobs = ref(false)
+  const loadingGallery = ref(false)
+
+  const sortedJobs = computed(() => [...jobs.value].sort((a, b) => +new Date(b.createdAt) - +new Date(a.createdAt)))
+  const sortedGalleryItems = computed(() => [...galleryItems.value].sort((a, b) => +new Date(b.createdAt) - +new Date(a.createdAt)))
+
+  async function fetchJobs() {
+    loadingJobs.value = true
+    try {
+      const res = await client.api.v1.nsfw.jobs.$get()
+      if (!res.ok)
+        throw new Error('Failed to fetch NSFW jobs')
+      const data = await res.json()
+      jobs.value = data.jobs as NsfwImageJob[]
+      return jobs.value
+    }
+    finally {
+      loadingJobs.value = false
+    }
+  }
+
+  async function createJob(input: {
+    characterId: string
+    route: 'normal' | 'nsfw'
+    prompt: string
+    negativePrompt: string
+    sceneType?: string
+    tags: string[]
+    params?: Record<string, unknown>
+  }) {
+    const res = await client.api.v1.nsfw.jobs.$post({
+      json: input,
+    })
+    if (!res.ok)
+      throw new Error('Failed to create NSFW image job')
+
+    const job = await res.json() as NsfwImageJob
+    jobs.value = [job, ...jobs.value]
+    return job
+  }
+
+  async function fetchGallery() {
+    loadingGallery.value = true
+    try {
+      const res = await client.api.v1.nsfw.gallery.$get()
+      if (!res.ok)
+        throw new Error('Failed to fetch NSFW gallery')
+      const data = await res.json()
+      galleryItems.value = data.items as NsfwGalleryItem[]
+      return galleryItems.value
+    }
+    finally {
+      loadingGallery.value = false
+    }
+  }
+
+  async function createGalleryItem(input: {
+    characterId: string
+    imageJobId?: string
+    mediaId?: string
+    title?: string
+    prompt: string
+    negativePrompt: string
+    sceneType?: string
+    tags: string[]
+  }) {
+    const res = await client.api.v1.nsfw.gallery.$post({
+      json: input,
+    })
+    if (!res.ok)
+      throw new Error('Failed to create NSFW gallery item')
+
+    const item = await res.json() as NsfwGalleryItem
+    galleryItems.value = [item, ...galleryItems.value]
+    return item
+  }
+
+  return {
+    jobs,
+    galleryItems,
+    loadingJobs,
+    loadingGallery,
+    sortedJobs,
+    sortedGalleryItems,
+    fetchJobs,
+    createJob,
+    fetchGallery,
+    createGalleryItem,
+  }
+})

From 8ae17a6ca4ad00537326168f80aaf27792eb423f Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 00:57:51 +0200
Subject: [PATCH 07/30] feat: add default comfyui workflow builder

---
 apps/server/src/libs/env.ts                   |   1 +
 .../services/nsfw-image-consumer-handler.ts   |  11 +-
 .../src/services/nsfw-image-workflow.ts       | 127 ++++++++++++++++++
 docs/content/en/nsfw-companion-index.md       |   5 +-
 docs/content/en/nsfw-companion-todo.md        |   3 +-
 .../stage-pages/src/pages/nsfw/generate.vue   |   2 +-
 6 files changed, 139 insertions(+), 10 deletions(-)
 create mode 100644 apps/server/src/services/nsfw-image-workflow.ts

diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index 973e7d4b54..9e2be3c1b6 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -63,6 +63,7 @@ const EnvSchema = object({
   NSFW_IMAGE_EVENTS_BLOCK_MS: optionalIntegerFromString(5000, 'NSFW_IMAGE_EVENTS_BLOCK_MS', 1),
   NSFW_IMAGE_EVENTS_MIN_IDLE_MS: optionalIntegerFromString(30000, 'NSFW_IMAGE_EVENTS_MIN_IDLE_MS', 1),
   COMFYUI_BASE_URL: optional(string(), 'http://127.0.0.1:8188'),
+  COMFYUI_DEFAULT_CHECKPOINT: optional(string(), 'v1-5-pruned-emaonly.safetensors'),
 
   // Database pool
   DB_POOL_MAX: optionalIntegerFromString(20, 'DB_POOL_MAX', 1),
diff --git a/apps/server/src/services/nsfw-image-consumer-handler.ts b/apps/server/src/services/nsfw-image-consumer-handler.ts
index 2572b38379..e301829bf2 100644
--- a/apps/server/src/services/nsfw-image-consumer-handler.ts
+++ b/apps/server/src/services/nsfw-image-consumer-handler.ts
@@ -4,6 +4,8 @@ import type { NsfwImageEvent } from './nsfw-image-events'
 
 import { useLogger } from '@guiiai/logg'
 
+import { buildDefaultComfyWorkflow } from './nsfw-image-workflow'
+
 const logger = useLogger('nsfw-image-consumer').useGlobalConfig()
 
 interface ComfyUiPromptSubmission {
@@ -124,18 +126,13 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         return
       }
 
-      const workflow = extractWorkflow(job.params)
-      if (!workflow) {
-        await mediaService.updateImageJobStatus(jobId, 'failed', {
-          errorMessage: 'No ComfyUI API workflow was attached to this job. Add params.workflow before enqueueing execution.',
-        })
-        return
-      }
+      const workflow = extractWorkflow(job.params) ?? buildDefaultComfyWorkflow(job, env)
 
       await mediaService.updateImageJobStatus(jobId, 'submitting', {
         errorMessage: null,
         params: {
           ...job.params,
+          workflow,
           comfy: {
             ...comfyMeta,
             promptId,
diff --git a/apps/server/src/services/nsfw-image-workflow.ts b/apps/server/src/services/nsfw-image-workflow.ts
new file mode 100644
index 0000000000..3e72f1397b
--- /dev/null
+++ b/apps/server/src/services/nsfw-image-workflow.ts
@@ -0,0 +1,127 @@
+import type { Env } from '../libs/env'
+import type { ImageJob } from '../schemas/nsfw-media'
+
+interface PlannerParams {
+  style?: string
+  mood?: string
+  framing?: string
+  aspectRatio?: string
+}
+
+type ComfyPromptWorkflow = Record<string, {
+  class_type: string
+  inputs: Record<string, unknown>
+}>
+
+function parsePlannerParams(params: Record<string, unknown>): PlannerParams {
+  const planner = params.planner
+  if (!planner || typeof planner !== 'object' || Array.isArray(planner)) {
+    return {}
+  }
+
+  const record = planner as Record<string, unknown>
+  return {
+    style: typeof record.style === 'string' ? record.style : undefined,
+    mood: typeof record.mood === 'string' ? record.mood : undefined,
+    framing: typeof record.framing === 'string' ? record.framing : undefined,
+    aspectRatio: typeof record.aspectRatio === 'string' ? record.aspectRatio : undefined,
+  }
+}
+
+function dimensionsFromAspectRatio(aspectRatio?: string) {
+  switch ((aspectRatio ?? '').trim()) {
+    case '3:4':
+      return { width: 768, height: 1024 }
+    case '4:3':
+      return { width: 1024, height: 768 }
+    case '16:9':
+      return { width: 1216, height: 704 }
+    case '9:16':
+      return { width: 704, height: 1216 }
+    case '1:1':
+      return { width: 1024, height: 1024 }
+    default:
+      return { width: 768, height: 1024 }
+  }
+}
+
+function workflowPrefix(job: ImageJob, planner: PlannerParams) {
+  return ['airi', job.route, job.characterId, planner.mood ?? 'scene']
+    .map(part => String(part).trim().replace(/[^a-zA-Z0-9_-]+/g, '-'))
+    .filter(Boolean)
+    .join('-')
+}
+
+export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptWorkflow {
+  const planner = parsePlannerParams(job.params)
+  const { width, height } = dimensionsFromAspectRatio(planner.aspectRatio)
+  const positiveText = [
+    job.prompt,
+    planner.style,
+    planner.mood,
+    planner.framing,
+  ].filter(Boolean).join(', ')
+
+  const seedSource = Number.parseInt(job.id.replace(/\D/g, '').slice(0, 9), 10)
+  const seed = Number.isFinite(seedSource) ? seedSource : Date.now() % 2147483647
+
+  return {
+    '3': {
+      class_type: 'KSampler',
+      inputs: {
+        cfg: 8,
+        denoise: 1,
+        latent_image: ['5', 0],
+        model: ['4', 0],
+        negative: ['7', 0],
+        positive: ['6', 0],
+        sampler_name: 'euler',
+        scheduler: 'normal',
+        seed,
+        steps: 24,
+      },
+    },
+    '4': {
+      class_type: 'CheckpointLoaderSimple',
+      inputs: {
+        ckpt_name: env.COMFYUI_DEFAULT_CHECKPOINT,
+      },
+    },
+    '5': {
+      class_type: 'EmptyLatentImage',
+      inputs: {
+        batch_size: 1,
+        height,
+        width,
+      },
+    },
+    '6': {
+      class_type: 'CLIPTextEncode',
+      inputs: {
+        clip: ['4', 1],
+        text: positiveText,
+      },
+    },
+    '7': {
+      class_type: 'CLIPTextEncode',
+      inputs: {
+        clip: ['4', 1],
+        text: job.negativePrompt,
+      },
+    },
+    '8': {
+      class_type: 'VAEDecode',
+      inputs: {
+        samples: ['3', 0],
+        vae: ['4', 2],
+      },
+    },
+    '9': {
+      class_type: 'SaveImage',
+      inputs: {
+        filename_prefix: workflowPrefix(job, planner),
+        images: ['8', 0],
+      },
+    },
+  }
+}
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index ed26fc9d1d..85d62d0c67 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -141,6 +141,8 @@ Role:
   - Redis Stream envelope for durable NSFW image execution requests
 - `apps/server/src/services/nsfw-image-consumer-handler.ts`
   - ComfyUI submission and `/history/{prompt_id}` reconciliation logic
+- `apps/server/src/services/nsfw-image-workflow.ts`
+  - builds a default API-format ComfyUI workflow from prompt, negative prompt, aspect ratio, and checkpoint config
 - `apps/server/src/bin/run-nsfw-image-consumer.ts`
   - standalone worker entrypoint for NSFW image execution
 - `apps/server/docker-compose.yml`
@@ -215,13 +217,14 @@ Role:
 - server-backed NSFW image job and gallery records
 - Redis-backed NSFW image execution queue
 - ComfyUI submit/reconcile worker path
+- default API-format ComfyUI workflow generation for NSFW jobs
 
 ### Still Open
 
 - server-side long-term memory
 - quality judge beyond simple heuristic flags
 - premium gating for NSFW media actions
-- a default real ComfyUI API workflow mapping for generated NSFW prompts
+- tuning the default ComfyUI workflow against the exact locally installed checkpoints
 - actual model wiring to `Hermes-4.3-36B`, `Grok 4.20`, and `GPT-5 mini`
 - build, typecheck, and tests once dependencies are installed
 
diff --git a/docs/content/en/nsfw-companion-todo.md b/docs/content/en/nsfw-companion-todo.md
index 0792a336e0..6ae33fc4c5 100644
--- a/docs/content/en/nsfw-companion-todo.md
+++ b/docs/content/en/nsfw-companion-todo.md
@@ -12,7 +12,8 @@ This is the implementation checklist for the AIRI + Hermes companion stack.
 - [x] Add a Redis-backed NSFW image queue and worker entrypoint in the AIRI server.
 - [x] Publish NSFW image jobs into the queue from `POST /api/v1/nsfw/jobs`.
 - [x] Add a ComfyUI submit/reconcile consumer path that treats AIRI as the source of truth.
-- [ ] Attach a real ComfyUI API workflow payload to `params.workflow` during NSFW image job creation.
+- [x] Add a default ComfyUI API workflow builder for NSFW image jobs.
+- [ ] Tune the default ComfyUI workflow against the exact checkpoints and node set installed on this machine.
 - [ ] Persist ComfyUI execution metadata more explicitly than the current `params.comfy` blob if recovery needs become more complex.
 
 ## AIRI
diff --git a/packages/stage-pages/src/pages/nsfw/generate.vue b/packages/stage-pages/src/pages/nsfw/generate.vue
index 811591635b..6f6dc055a4 100644
--- a/packages/stage-pages/src/pages/nsfw/generate.vue
+++ b/packages/stage-pages/src/pages/nsfw/generate.vue
@@ -259,7 +259,7 @@ async function saveToGallery() {
                   class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 font-mono text-xs outline-none dark:border-neutral-700 dark:bg-neutral-800"
                 />
                 <p class="text-xs text-neutral-500 leading-5 dark:text-neutral-400">
-                  Optional, but required for actual ComfyUI execution. Paste a real API-format workflow object here if you want the queued job to run instead of only being planned and stored.
+                  Optional override. If left empty, AIRI now builds a default API-format ComfyUI workflow from the planned prompt, negative prompt, aspect ratio, and server checkpoint setting.
                 </p>
               </div>
 

From cfc10912c0e65bc82055b5556e23d7c4c1aecd45 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 01:52:34 +0200
Subject: [PATCH 08/30] chore: target local comfyui checkpoint

---
 apps/server/src/libs/env.ts             | 2 +-
 docs/content/en/nsfw-companion-index.md | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index 9e2be3c1b6..004bd855d1 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -63,7 +63,7 @@ const EnvSchema = object({
   NSFW_IMAGE_EVENTS_BLOCK_MS: optionalIntegerFromString(5000, 'NSFW_IMAGE_EVENTS_BLOCK_MS', 1),
   NSFW_IMAGE_EVENTS_MIN_IDLE_MS: optionalIntegerFromString(30000, 'NSFW_IMAGE_EVENTS_MIN_IDLE_MS', 1),
   COMFYUI_BASE_URL: optional(string(), 'http://127.0.0.1:8188'),
-  COMFYUI_DEFAULT_CHECKPOINT: optional(string(), 'v1-5-pruned-emaonly.safetensors'),
+  COMFYUI_DEFAULT_CHECKPOINT: optional(string(), 'ponyDiffusionV6.safetensors'),
 
   // Database pool
   DB_POOL_MAX: optionalIntegerFromString(20, 'DB_POOL_MAX', 1),
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 85d62d0c67..85822fe9e9 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -143,6 +143,7 @@ Role:
   - ComfyUI submission and `/history/{prompt_id}` reconciliation logic
 - `apps/server/src/services/nsfw-image-workflow.ts`
   - builds a default API-format ComfyUI workflow from prompt, negative prompt, aspect ratio, and checkpoint config
+  - currently targets the locally present `ponyDiffusionV6.safetensors` checkpoint by default
 - `apps/server/src/bin/run-nsfw-image-consumer.ts`
   - standalone worker entrypoint for NSFW image execution
 - `apps/server/docker-compose.yml`

From 9e2ad4ab1c1d125fcfc2c742ca88f3d633a13049 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 02:51:22 +0200
Subject: [PATCH 09/30] feat: tune default pony workflow quality

---
 apps/server/src/libs/env.ts                   |  6 +++
 .../src/services/nsfw-image-workflow.ts       | 50 +++++++++++++++++--
 docs/content/en/nsfw-companion-index.md       |  1 +
 docs/content/en/nsfw-companion-todo.md        |  2 +-
 4 files changed, 54 insertions(+), 5 deletions(-)

diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index 004bd855d1..4783931250 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -64,6 +64,12 @@ const EnvSchema = object({
   NSFW_IMAGE_EVENTS_MIN_IDLE_MS: optionalIntegerFromString(30000, 'NSFW_IMAGE_EVENTS_MIN_IDLE_MS', 1),
   COMFYUI_BASE_URL: optional(string(), 'http://127.0.0.1:8188'),
   COMFYUI_DEFAULT_CHECKPOINT: optional(string(), 'ponyDiffusionV6.safetensors'),
+  COMFYUI_DEFAULT_LORA: optional(string(), 'pony_realism.safetensors'),
+  COMFYUI_DEFAULT_LORA_STRENGTH_MODEL: optionalNumberFromString(0.8, 'COMFYUI_DEFAULT_LORA_STRENGTH_MODEL', 0, 2),
+  COMFYUI_DEFAULT_LORA_STRENGTH_CLIP: optionalNumberFromString(0.8, 'COMFYUI_DEFAULT_LORA_STRENGTH_CLIP', 0, 2),
+  COMFYUI_SECONDARY_LORA: optional(string(), 'realistic-skin-texture-style-xl-detailed-skin-sd1.5-flux1d-pony-illu.safetensors'),
+  COMFYUI_SECONDARY_LORA_STRENGTH_MODEL: optionalNumberFromString(0.55, 'COMFYUI_SECONDARY_LORA_STRENGTH_MODEL', 0, 2),
+  COMFYUI_SECONDARY_LORA_STRENGTH_CLIP: optionalNumberFromString(0.4, 'COMFYUI_SECONDARY_LORA_STRENGTH_CLIP', 0, 2),
 
   // Database pool
   DB_POOL_MAX: optionalIntegerFromString(20, 'DB_POOL_MAX', 1),
diff --git a/apps/server/src/services/nsfw-image-workflow.ts b/apps/server/src/services/nsfw-image-workflow.ts
index 3e72f1397b..997c20e256 100644
--- a/apps/server/src/services/nsfw-image-workflow.ts
+++ b/apps/server/src/services/nsfw-image-workflow.ts
@@ -65,14 +65,28 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
   const seedSource = Number.parseInt(job.id.replace(/\D/g, '').slice(0, 9), 10)
   const seed = Number.isFinite(seedSource) ? seedSource : Date.now() % 2147483647
 
-  return {
+  const primaryLoraEnabled = Boolean(env.COMFYUI_DEFAULT_LORA?.trim())
+  const secondaryLoraEnabled = Boolean(env.COMFYUI_SECONDARY_LORA?.trim())
+
+  const modelSource: [string, number] = secondaryLoraEnabled
+    ? ['11', 0]
+    : primaryLoraEnabled
+        ? ['10', 0]
+        : ['4', 0]
+
+  const clipSource: [string, number] = secondaryLoraEnabled
+    ? ['11', 1]
+    : primaryLoraEnabled
+        ? ['10', 1]
+        : ['4', 1]
+  const workflow: ComfyPromptWorkflow = {
     '3': {
       class_type: 'KSampler',
       inputs: {
         cfg: 8,
         denoise: 1,
         latent_image: ['5', 0],
-        model: ['4', 0],
+        model: modelSource,
         negative: ['7', 0],
         positive: ['6', 0],
         sampler_name: 'euler',
@@ -98,14 +112,14 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
     '6': {
       class_type: 'CLIPTextEncode',
       inputs: {
-        clip: ['4', 1],
+        clip: clipSource,
         text: positiveText,
       },
     },
     '7': {
       class_type: 'CLIPTextEncode',
       inputs: {
-        clip: ['4', 1],
+        clip: clipSource,
         text: job.negativePrompt,
       },
     },
@@ -124,4 +138,32 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
       },
     },
   }
+
+  if (primaryLoraEnabled) {
+    workflow['10'] = {
+      class_type: 'LoraLoader',
+      inputs: {
+        model: ['4', 0],
+        clip: ['4', 1],
+        lora_name: env.COMFYUI_DEFAULT_LORA,
+        strength_model: env.COMFYUI_DEFAULT_LORA_STRENGTH_MODEL,
+        strength_clip: env.COMFYUI_DEFAULT_LORA_STRENGTH_CLIP,
+      },
+    }
+  }
+
+  if (secondaryLoraEnabled) {
+    workflow['11'] = {
+      class_type: 'LoraLoader',
+      inputs: {
+        model: primaryLoraEnabled ? ['10', 0] : ['4', 0],
+        clip: primaryLoraEnabled ? ['10', 1] : ['4', 1],
+        lora_name: env.COMFYUI_SECONDARY_LORA,
+        strength_model: env.COMFYUI_SECONDARY_LORA_STRENGTH_MODEL,
+        strength_clip: env.COMFYUI_SECONDARY_LORA_STRENGTH_CLIP,
+      },
+    }
+  }
+
+  return workflow
 }
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 85822fe9e9..ff6b3fa38e 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -144,6 +144,7 @@ Role:
 - `apps/server/src/services/nsfw-image-workflow.ts`
   - builds a default API-format ComfyUI workflow from prompt, negative prompt, aspect ratio, and checkpoint config
   - currently targets the locally present `ponyDiffusionV6.safetensors` checkpoint by default
+  - applies the locally present `pony_realism.safetensors` and skin-texture LoRA chain by default
 - `apps/server/src/bin/run-nsfw-image-consumer.ts`
   - standalone worker entrypoint for NSFW image execution
 - `apps/server/docker-compose.yml`
diff --git a/docs/content/en/nsfw-companion-todo.md b/docs/content/en/nsfw-companion-todo.md
index 6ae33fc4c5..f24cfe6264 100644
--- a/docs/content/en/nsfw-companion-todo.md
+++ b/docs/content/en/nsfw-companion-todo.md
@@ -13,7 +13,7 @@ This is the implementation checklist for the AIRI + Hermes companion stack.
 - [x] Publish NSFW image jobs into the queue from `POST /api/v1/nsfw/jobs`.
 - [x] Add a ComfyUI submit/reconcile consumer path that treats AIRI as the source of truth.
 - [x] Add a default ComfyUI API workflow builder for NSFW image jobs.
-- [ ] Tune the default ComfyUI workflow against the exact checkpoints and node set installed on this machine.
+- [x] Tune the default ComfyUI workflow against the exact locally installed Pony checkpoint and LoRA stack.
 - [ ] Persist ComfyUI execution metadata more explicitly than the current `params.comfy` blob if recovery needs become more complex.
 
 ## AIRI

From 939a3cda64f00be7c2d403e4b6582d7ca2a01a4a Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 04:58:45 +0200
Subject: [PATCH 10/30] fix: polish nsfw image runtime status handling

---
 apps/server/src/libs/mq/worker.ts               | 11 +++++++++--
 .../src/services/nsfw-image-consumer-handler.ts |  4 ++--
 docs/content/en/nsfw-companion-index.md         | 17 ++++++++++++++++-
 3 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/apps/server/src/libs/mq/worker.ts b/apps/server/src/libs/mq/worker.ts
index 8f9edf14fd..d51b802e50 100644
--- a/apps/server/src/libs/mq/worker.ts
+++ b/apps/server/src/libs/mq/worker.ts
@@ -44,11 +44,18 @@ export function createMqWorker<TEvent>(mq: MqService<TEvent>) {
             await mq.ack(options.group, message.streamMessageId)
           }
           catch (error) {
-            logger.withError(error).withFields({
+            const log = logger.withFields({
               group: options.group,
               consumer: options.consumer,
               streamMessageId: message.streamMessageId,
-            }).error('MQ handler failed; leaving message pending')
+            })
+
+            if (error instanceof Error && error.name === 'JobStillRunningError') {
+              log.withError(error).warn('MQ handler deferred; message remains pending for retry')
+              continue
+            }
+
+            log.withError(error).error('MQ handler failed; leaving message pending')
           }
         }
       }
diff --git a/apps/server/src/services/nsfw-image-consumer-handler.ts b/apps/server/src/services/nsfw-image-consumer-handler.ts
index e301829bf2..d8f10a0ec4 100644
--- a/apps/server/src/services/nsfw-image-consumer-handler.ts
+++ b/apps/server/src/services/nsfw-image-consumer-handler.ts
@@ -1,6 +1,6 @@
 import type { Env } from '../libs/env'
-import type { NsfwMediaService } from './nsfw-media'
 import type { NsfwImageEvent } from './nsfw-image-events'
+import type { NsfwMediaService } from './nsfw-media'
 
 import { useLogger } from '@guiiai/logg'
 
@@ -31,7 +31,7 @@ interface ComfyUiHistoryResponse {
   }
 }
 
-class JobStillRunningError extends Error {
+export class JobStillRunningError extends Error {
   constructor(message: string) {
     super(message)
     this.name = 'JobStillRunningError'
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index ff6b3fa38e..149884748d 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -221,12 +221,27 @@ Role:
 - ComfyUI submit/reconcile worker path
 - default API-format ComfyUI workflow generation for NSFW jobs
 
+### Live Runtime Status
+
+- Local ComfyUI now starts and serves `http://127.0.0.1:8188`
+- Local Postgres and Redis now run through `apps/server/docker-compose.yml`
+- `nsfw-image-consumer` now connects to local Postgres and Redis and applies migrations successfully
+- A real runtime test job was accepted by ComfyUI and appears in `queue_running`
+- Current end-to-end runtime path is proven through:
+  - AIRI job record
+  - Redis event
+  - worker pickup
+  - ComfyUI prompt submission
+  - ComfyUI queue visibility
+- Final image completion is still slow in the current `--cpu` ComfyUI run, so completion timing is not yet representative of the intended GPU path
+
 ### Still Open
 
 - server-side long-term memory
 - quality judge beyond simple heuristic flags
 - premium gating for NSFW media actions
-- tuning the default ComfyUI workflow against the exact locally installed checkpoints
+- GPU-backed ComfyUI runtime validation
+- final image completion and gallery reconciliation validation on a non-CPU render path
 - actual model wiring to `Hermes-4.3-36B`, `Grok 4.20`, and `GPT-5 mini`
 - build, typecheck, and tests once dependencies are installed
 

From 50b18b0c94f6022b35bb5ea9bd403713c511e053 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 05:13:29 +0200
Subject: [PATCH 11/30] feat: add comfyui smoke test tuning

---
 apps/server/src/libs/env.ts                   |  3 ++
 .../src/services/nsfw-image-workflow.ts       | 49 +++++++++++++------
 docs/content/en/nsfw-companion-index.md       |  4 ++
 3 files changed, 41 insertions(+), 15 deletions(-)

diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index 4783931250..d28733c2fa 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -64,6 +64,9 @@ const EnvSchema = object({
   NSFW_IMAGE_EVENTS_MIN_IDLE_MS: optionalIntegerFromString(30000, 'NSFW_IMAGE_EVENTS_MIN_IDLE_MS', 1),
   COMFYUI_BASE_URL: optional(string(), 'http://127.0.0.1:8188'),
   COMFYUI_DEFAULT_CHECKPOINT: optional(string(), 'ponyDiffusionV6.safetensors'),
+  COMFYUI_DEFAULT_STEPS: optionalIntegerFromString(24, 'COMFYUI_DEFAULT_STEPS', 1),
+  COMFYUI_DEFAULT_CFG: optionalNumberFromString(8, 'COMFYUI_DEFAULT_CFG', 1, 30),
+  COMFYUI_MAX_DIMENSION: optionalIntegerFromString(1216, 'COMFYUI_MAX_DIMENSION', 64),
   COMFYUI_DEFAULT_LORA: optional(string(), 'pony_realism.safetensors'),
   COMFYUI_DEFAULT_LORA_STRENGTH_MODEL: optionalNumberFromString(0.8, 'COMFYUI_DEFAULT_LORA_STRENGTH_MODEL', 0, 2),
   COMFYUI_DEFAULT_LORA_STRENGTH_CLIP: optionalNumberFromString(0.8, 'COMFYUI_DEFAULT_LORA_STRENGTH_CLIP', 0, 2),
diff --git a/apps/server/src/services/nsfw-image-workflow.ts b/apps/server/src/services/nsfw-image-workflow.ts
index 997c20e256..d7ed41e1ca 100644
--- a/apps/server/src/services/nsfw-image-workflow.ts
+++ b/apps/server/src/services/nsfw-image-workflow.ts
@@ -45,16 +45,35 @@ function dimensionsFromAspectRatio(aspectRatio?: string) {
   }
 }
 
+function clampDimensions(width: number, height: number, maxDimension: number) {
+  const largestDimension = Math.max(width, height)
+  if (largestDimension <= maxDimension) {
+    return { width, height }
+  }
+
+  const scale = maxDimension / largestDimension
+  const clamp = (value: number) => {
+    const scaled = Math.max(64, Math.round((value * scale) / 64) * 64)
+    return scaled
+  }
+
+  return {
+    width: clamp(width),
+    height: clamp(height),
+  }
+}
+
 function workflowPrefix(job: ImageJob, planner: PlannerParams) {
   return ['airi', job.route, job.characterId, planner.mood ?? 'scene']
-    .map(part => String(part).trim().replace(/[^a-zA-Z0-9_-]+/g, '-'))
+    .map(part => String(part).trim().replace(/[^\w-]+/g, '-'))
     .filter(Boolean)
     .join('-')
 }
 
 export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptWorkflow {
   const planner = parsePlannerParams(job.params)
-  const { width, height } = dimensionsFromAspectRatio(planner.aspectRatio)
+  const baseDimensions = dimensionsFromAspectRatio(planner.aspectRatio)
+  const { width, height } = clampDimensions(baseDimensions.width, baseDimensions.height, env.COMFYUI_MAX_DIMENSION)
   const positiveText = [
     job.prompt,
     planner.style,
@@ -71,19 +90,19 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
   const modelSource: [string, number] = secondaryLoraEnabled
     ? ['11', 0]
     : primaryLoraEnabled
-        ? ['10', 0]
-        : ['4', 0]
+      ? ['10', 0]
+      : ['4', 0]
 
   const clipSource: [string, number] = secondaryLoraEnabled
     ? ['11', 1]
     : primaryLoraEnabled
-        ? ['10', 1]
-        : ['4', 1]
+      ? ['10', 1]
+      : ['4', 1]
   const workflow: ComfyPromptWorkflow = {
-    '3': {
+    3: {
       class_type: 'KSampler',
       inputs: {
-        cfg: 8,
+        cfg: env.COMFYUI_DEFAULT_CFG,
         denoise: 1,
         latent_image: ['5', 0],
         model: modelSource,
@@ -92,16 +111,16 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
         sampler_name: 'euler',
         scheduler: 'normal',
         seed,
-        steps: 24,
+        steps: env.COMFYUI_DEFAULT_STEPS,
       },
     },
-    '4': {
+    4: {
       class_type: 'CheckpointLoaderSimple',
       inputs: {
         ckpt_name: env.COMFYUI_DEFAULT_CHECKPOINT,
       },
     },
-    '5': {
+    5: {
       class_type: 'EmptyLatentImage',
       inputs: {
         batch_size: 1,
@@ -109,28 +128,28 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
         width,
       },
     },
-    '6': {
+    6: {
       class_type: 'CLIPTextEncode',
       inputs: {
         clip: clipSource,
         text: positiveText,
       },
     },
-    '7': {
+    7: {
       class_type: 'CLIPTextEncode',
       inputs: {
         clip: clipSource,
         text: job.negativePrompt,
       },
     },
-    '8': {
+    8: {
       class_type: 'VAEDecode',
       inputs: {
         samples: ['3', 0],
         vae: ['4', 2],
       },
     },
-    '9': {
+    9: {
       class_type: 'SaveImage',
       inputs: {
         filename_prefix: workflowPrefix(job, planner),
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 149884748d..a7d0b3ad74 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -234,6 +234,10 @@ Role:
   - ComfyUI prompt submission
   - ComfyUI queue visibility
 - Final image completion is still slow in the current `--cpu` ComfyUI run, so completion timing is not yet representative of the intended GPU path
+- The default workflow now supports env-level smoke-test tuning through:
+  - `COMFYUI_DEFAULT_STEPS`
+  - `COMFYUI_DEFAULT_CFG`
+  - `COMFYUI_MAX_DIMENSION`
 
 ### Still Open
 

From 5add5e37f88b0fa34eb0dd8391fc29495ed23c7e Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 05:18:25 +0200
Subject: [PATCH 12/30] docs: record sd turbo smoke test status

---
 docs/content/en/nsfw-companion-index.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index a7d0b3ad74..ae375d8873 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -227,13 +227,18 @@ Role:
 - Local Postgres and Redis now run through `apps/server/docker-compose.yml`
 - `nsfw-image-consumer` now connects to local Postgres and Redis and applies migrations successfully
 - A real runtime test job was accepted by ComfyUI and appears in `queue_running`
+- A second ultra-light CPU smoke test was also accepted with:
+  - `sd_turbo.safetensors`
+  - `4` steps
+  - `512x512`
+  - no LoRA chain
 - Current end-to-end runtime path is proven through:
   - AIRI job record
   - Redis event
   - worker pickup
   - ComfyUI prompt submission
   - ComfyUI queue visibility
-- Final image completion is still slow in the current `--cpu` ComfyUI run, so completion timing is not yet representative of the intended GPU path
+- Final image completion is still slow in the current `--cpu` ComfyUI run, so completion timing and gallery reconciliation are not yet representative of the intended GPU path
 - The default workflow now supports env-level smoke-test tuning through:
   - `COMFYUI_DEFAULT_STEPS`
   - `COMFYUI_DEFAULT_CFG`

From 620b9bd7dce080acdc3c53d71e1164ae1bde7cd5 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 05:21:40 +0200
Subject: [PATCH 13/30] fix: harden comfyui job timeouts

---
 apps/server/src/libs/env.ts                   |  2 +
 .../services/nsfw-image-consumer-handler.ts   | 48 +++++++++++++++++++
 docs/content/en/nsfw-companion-index.md       |  3 ++
 3 files changed, 53 insertions(+)

diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index d28733c2fa..e7ec6a3eab 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -67,6 +67,8 @@ const EnvSchema = object({
   COMFYUI_DEFAULT_STEPS: optionalIntegerFromString(24, 'COMFYUI_DEFAULT_STEPS', 1),
   COMFYUI_DEFAULT_CFG: optionalNumberFromString(8, 'COMFYUI_DEFAULT_CFG', 1, 30),
   COMFYUI_MAX_DIMENSION: optionalIntegerFromString(1216, 'COMFYUI_MAX_DIMENSION', 64),
+  COMFYUI_SUBMIT_TIMEOUT_MS: optionalIntegerFromString(120000, 'COMFYUI_SUBMIT_TIMEOUT_MS', 1000),
+  COMFYUI_RUNNING_TIMEOUT_MS: optionalIntegerFromString(900000, 'COMFYUI_RUNNING_TIMEOUT_MS', 1000),
   COMFYUI_DEFAULT_LORA: optional(string(), 'pony_realism.safetensors'),
   COMFYUI_DEFAULT_LORA_STRENGTH_MODEL: optionalNumberFromString(0.8, 'COMFYUI_DEFAULT_LORA_STRENGTH_MODEL', 0, 2),
   COMFYUI_DEFAULT_LORA_STRENGTH_CLIP: optionalNumberFromString(0.8, 'COMFYUI_DEFAULT_LORA_STRENGTH_CLIP', 0, 2),
diff --git a/apps/server/src/services/nsfw-image-consumer-handler.ts b/apps/server/src/services/nsfw-image-consumer-handler.ts
index d8f10a0ec4..23532e6105 100644
--- a/apps/server/src/services/nsfw-image-consumer-handler.ts
+++ b/apps/server/src/services/nsfw-image-consumer-handler.ts
@@ -81,6 +81,33 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
     return comfy as Record<string, unknown>
   }
 
+  function parseIsoTimestamp(value: unknown) {
+    if (typeof value !== 'string') {
+      return null
+    }
+
+    const timestamp = Date.parse(value)
+    return Number.isFinite(timestamp) ? timestamp : null
+  }
+
+  function isTimedOut(jobStatus: string, comfyMeta: Record<string, unknown>) {
+    const now = Date.now()
+    const submittedAt = parseIsoTimestamp(comfyMeta.submittedAt)
+    if (submittedAt !== null) {
+      const timeoutMs = jobStatus === 'submitting'
+        ? env.COMFYUI_SUBMIT_TIMEOUT_MS
+        : env.COMFYUI_RUNNING_TIMEOUT_MS
+      return now - submittedAt >= timeoutMs
+    }
+
+    const startedAt = parseIsoTimestamp(comfyMeta.startedAt)
+    if (startedAt !== null) {
+      return now - startedAt >= env.COMFYUI_RUNNING_TIMEOUT_MS
+    }
+
+    return false
+  }
+
   return {
     async handleMessage(event: NsfwImageEvent) {
       const jobId = event.payload.jobId
@@ -101,6 +128,26 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
       if (job.status === 'running' || job.status === 'submitting') {
         const history = await fetchComfyHistory(promptId)
         if (!history) {
+          if (isTimedOut(job.status, comfyMeta)) {
+            const timeoutMs = job.status === 'submitting'
+              ? env.COMFYUI_SUBMIT_TIMEOUT_MS
+              : env.COMFYUI_RUNNING_TIMEOUT_MS
+
+            await mediaService.updateImageJobStatus(jobId, 'failed', {
+              errorMessage: `ComfyUI job ${promptId} timed out after ${timeoutMs}ms without producing history`,
+              params: {
+                ...job.params,
+                comfy: {
+                  ...comfyMeta,
+                  promptId,
+                  clientId,
+                  timedOutAt: new Date().toISOString(),
+                },
+              },
+            })
+            return
+          }
+
           throw new JobStillRunningError(`ComfyUI job ${promptId} has not produced history yet`)
         }
 
@@ -171,6 +218,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
             queueNumber: submission.number,
             nodeErrors: submission.node_errors,
             submittedAt: new Date().toISOString(),
+            startedAt: new Date().toISOString(),
           },
         },
       })
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index ae375d8873..b2f90f3aa0 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -243,6 +243,9 @@ Role:
   - `COMFYUI_DEFAULT_STEPS`
   - `COMFYUI_DEFAULT_CFG`
   - `COMFYUI_MAX_DIMENSION`
+- Stuck ComfyUI jobs can now fail cleanly through:
+  - `COMFYUI_SUBMIT_TIMEOUT_MS`
+  - `COMFYUI_RUNNING_TIMEOUT_MS`
 
 ### Still Open
 

From 706b509d622c191eb08e0eeb680185303fee9c8e Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 05:31:13 +0200
Subject: [PATCH 14/30] feat: surface nsfw gallery job status

---
 apps/server/src/services/nsfw-media.ts        | 26 +++++++--
 .../stage-pages/src/pages/nsfw/gallery.vue    | 54 ++++++++++++++++---
 packages/stage-ui/src/stores/nsfw-media.ts    |  3 ++
 3 files changed, 73 insertions(+), 10 deletions(-)

diff --git a/apps/server/src/services/nsfw-media.ts b/apps/server/src/services/nsfw-media.ts
index cf18c4adb9..588a0f14ca 100644
--- a/apps/server/src/services/nsfw-media.ts
+++ b/apps/server/src/services/nsfw-media.ts
@@ -53,10 +53,28 @@ export function createNsfwMediaService(db: Database) {
     },
 
     async listGalleryItems(userId: string) {
-      return await db.query.galleryItems.findMany({
-        where: eq(schema.galleryItems.userId, userId),
-        orderBy: desc(schema.galleryItems.createdAt),
-      })
+      return await db
+        .select({
+          id: schema.galleryItems.id,
+          userId: schema.galleryItems.userId,
+          characterId: schema.galleryItems.characterId,
+          imageJobId: schema.galleryItems.imageJobId,
+          mediaId: schema.galleryItems.mediaId,
+          title: schema.galleryItems.title,
+          prompt: schema.galleryItems.prompt,
+          negativePrompt: schema.galleryItems.negativePrompt,
+          sceneType: schema.galleryItems.sceneType,
+          tags: schema.galleryItems.tags,
+          createdAt: schema.galleryItems.createdAt,
+          updatedAt: schema.galleryItems.updatedAt,
+          imageJobStatus: schema.imageJobs.status,
+          imageJobErrorMessage: schema.imageJobs.errorMessage,
+          imageJobResultMediaId: schema.imageJobs.resultMediaId,
+        })
+        .from(schema.galleryItems)
+        .leftJoin(schema.imageJobs, eq(schema.galleryItems.imageJobId, schema.imageJobs.id))
+        .where(eq(schema.galleryItems.userId, userId))
+        .orderBy(desc(schema.galleryItems.createdAt))
     },
 
     async updateGalleryItemByImageJobId(imageJobId: string, data: Partial<schema.NewGalleryItem>) {
diff --git a/packages/stage-pages/src/pages/nsfw/gallery.vue b/packages/stage-pages/src/pages/nsfw/gallery.vue
index a8a6eab6c7..c1d2127165 100644
--- a/packages/stage-pages/src/pages/nsfw/gallery.vue
+++ b/packages/stage-pages/src/pages/nsfw/gallery.vue
@@ -19,16 +19,30 @@ onMounted(() => {
 function formatDate(value: number) {
   return new Date(value).toLocaleString()
 }
+
+function statusTone(status?: string | null) {
+  switch (status) {
+    case 'done':
+      return 'bg-emerald-100 text-emerald-700 dark:bg-emerald-500/15 dark:text-emerald-300'
+    case 'failed':
+      return 'bg-rose-100 text-rose-700 dark:bg-rose-500/15 dark:text-rose-300'
+    case 'running':
+    case 'submitting':
+      return 'bg-amber-100 text-amber-700 dark:bg-amber-500/15 dark:text-amber-300'
+    default:
+      return 'bg-neutral-100 text-neutral-700 dark:bg-neutral-800 dark:text-neutral-300'
+  }
+}
 </script>
 
 <template>
   <div class="min-h-screen px-4 py-8 md:px-8">
     <div mx-auto max-w-6xl class="space-y-6">
-      <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-amber-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
+      <section class="bg-linear-to-br relative overflow-hidden rounded-[2rem] from-neutral-950 via-amber-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
         <div class="absolute right--12 top--14 h-60 w-60 rounded-full bg-amber-400/15 blur-3xl" />
         <div class="absolute bottom--12 left-8 h-48 w-48 rounded-full bg-orange-300/10 blur-3xl" />
         <div class="relative z-1 max-w-3xl">
-          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.16em] backdrop-blur">
+          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium tracking-[0.16em] uppercase backdrop-blur">
             NSFW Gallery
           </div>
           <h1 class="text-4xl font-semibold leading-tight md:text-5xl">
@@ -82,18 +96,46 @@ function formatDate(value: number) {
         >
           <div class="flex items-start justify-between gap-4">
             <div>
-              <div class="text-xs uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+              <div class="text-xs text-neutral-500 tracking-[0.16em] uppercase dark:text-neutral-400">
                 {{ item.title || item.characterId }}
               </div>
               <div class="mt-2 text-lg font-semibold">
                 {{ item.sceneType || 'nsfw' }}
               </div>
             </div>
+            <div
+              v-if="item.imageJobStatus"
+              class="rounded-full px-3 py-1 text-xs font-medium tracking-[0.12em] uppercase"
+              :class="statusTone(item.imageJobStatus)"
+            >
+              {{ item.imageJobStatus }}
+            </div>
           </div>
 
           <div class="mt-4 space-y-4">
+            <div
+              v-if="item.imageJobErrorMessage"
+              class="rounded-2xl bg-rose-50 px-4 py-4 text-sm text-rose-700 leading-6 dark:bg-rose-500/10 dark:text-rose-200"
+            >
+              {{ item.imageJobErrorMessage }}
+            </div>
+
+            <div
+              v-else-if="item.imageJobStatus === 'running' || item.imageJobStatus === 'submitting' || item.imageJobStatus === 'queued'"
+              class="rounded-2xl bg-amber-50 px-4 py-4 text-sm text-amber-700 leading-6 dark:bg-amber-500/10 dark:text-amber-200"
+            >
+              Render job is still processing in ComfyUI.
+            </div>
+
+            <div
+              v-else-if="item.imageJobResultMediaId || item.mediaId"
+              class="rounded-2xl bg-emerald-50 px-4 py-4 text-sm text-emerald-700 leading-6 dark:bg-emerald-500/10 dark:text-emerald-200"
+            >
+              Media ready: {{ item.imageJobResultMediaId || item.mediaId }}
+            </div>
+
             <div>
-              <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+              <div class="text-[11px] text-neutral-500 font-medium tracking-[0.16em] uppercase dark:text-neutral-400">
                 Prompt
               </div>
               <div class="mt-2 rounded-2xl bg-neutral-50 px-4 py-4 text-sm leading-6 dark:bg-neutral-800">
@@ -102,7 +144,7 @@ function formatDate(value: number) {
             </div>
 
             <div>
-              <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+              <div class="text-[11px] text-neutral-500 font-medium tracking-[0.16em] uppercase dark:text-neutral-400">
                 Negative Prompt
               </div>
               <div class="mt-2 rounded-2xl bg-neutral-50 px-4 py-4 text-sm leading-6 dark:bg-neutral-800">
@@ -114,7 +156,7 @@ function formatDate(value: number) {
               <span
                 v-for="tag in item.tags"
                 :key="`${item.id}:${tag}`"
-                class="rounded-full bg-amber-100 px-3 py-1 text-xs font-medium text-amber-700 dark:bg-amber-500/15 dark:text-amber-300"
+                class="rounded-full bg-amber-100 px-3 py-1 text-xs text-amber-700 font-medium dark:bg-amber-500/15 dark:text-amber-300"
               >
                 {{ tag }}
               </span>
diff --git a/packages/stage-ui/src/stores/nsfw-media.ts b/packages/stage-ui/src/stores/nsfw-media.ts
index 01b27d5b7b..b9d66dbcf2 100644
--- a/packages/stage-ui/src/stores/nsfw-media.ts
+++ b/packages/stage-ui/src/stores/nsfw-media.ts
@@ -31,6 +31,9 @@ export interface NsfwGalleryItem {
   negativePrompt: string
   sceneType?: string | null
   tags: string[]
+  imageJobStatus?: 'queued' | 'submitting' | 'running' | 'done' | 'failed' | null
+  imageJobErrorMessage?: string | null
+  imageJobResultMediaId?: string | null
   createdAt: string | number | Date
   updatedAt: string | number | Date
 }

From 171bae25dad0cfaeba32ecbc3e6aa35ade828bd9 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 05:33:57 +0200
Subject: [PATCH 15/30] feat: poll nsfw gallery while jobs run

---
 .../stage-pages/src/pages/nsfw/gallery.vue    | 40 ++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/packages/stage-pages/src/pages/nsfw/gallery.vue b/packages/stage-pages/src/pages/nsfw/gallery.vue
index c1d2127165..7157707314 100644
--- a/packages/stage-pages/src/pages/nsfw/gallery.vue
+++ b/packages/stage-pages/src/pages/nsfw/gallery.vue
@@ -2,24 +2,62 @@
 import { useAuthStore } from '@proj-airi/stage-ui/stores/auth'
 import { useNsfwMediaStore } from '@proj-airi/stage-ui/stores/nsfw-media'
 import { Button } from '@proj-airi/ui'
-import { computed, onMounted } from 'vue'
+import { computed, onBeforeUnmount, onMounted, watch } from 'vue'
 import { useRouter } from 'vue-router'
 
 const router = useRouter()
 const authStore = useAuthStore()
 const mediaStore = useNsfwMediaStore()
+let pollHandle: ReturnType<typeof setInterval> | null = null
 
 const accessDenied = computed(() => !authStore.canAccessNsfw)
 const items = computed(() => mediaStore.sortedGalleryItems)
+const hasActiveJobs = computed(() => items.value.some(item =>
+  item.imageJobStatus === 'queued'
+  || item.imageJobStatus === 'submitting'
+  || item.imageJobStatus === 'running',
+))
 
 onMounted(() => {
   mediaStore.fetchGallery().catch(() => {})
 })
 
+onBeforeUnmount(() => {
+  stopPolling()
+})
+
+watch([accessDenied, hasActiveJobs], ([denied, active]) => {
+  if (denied || !active) {
+    stopPolling()
+    return
+  }
+
+  startPolling()
+}, { immediate: true })
+
 function formatDate(value: number) {
   return new Date(value).toLocaleString()
 }
 
+function startPolling() {
+  if (pollHandle) {
+    return
+  }
+
+  pollHandle = setInterval(() => {
+    mediaStore.fetchGallery().catch(() => {})
+  }, 5000)
+}
+
+function stopPolling() {
+  if (!pollHandle) {
+    return
+  }
+
+  clearInterval(pollHandle)
+  pollHandle = null
+}
+
 function statusTone(status?: string | null) {
   switch (status) {
     case 'done':

From bc0cbcbfd1759aa74af5e1bcabfbb6baab8d631f Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 31 Mar 2026 07:12:54 +0200
Subject: [PATCH 16/30] fix: harden nsfw comfy workflow fallback

---
 .../services/nsfw-image-consumer-handler.ts   | 111 +++++++++++++++++-
 docs/content/en/nsfw-companion-index.md       |   4 +
 2 files changed, 114 insertions(+), 1 deletion(-)

diff --git a/apps/server/src/services/nsfw-image-consumer-handler.ts b/apps/server/src/services/nsfw-image-consumer-handler.ts
index 23532e6105..93dd99403a 100644
--- a/apps/server/src/services/nsfw-image-consumer-handler.ts
+++ b/apps/server/src/services/nsfw-image-consumer-handler.ts
@@ -14,6 +14,16 @@ interface ComfyUiPromptSubmission {
   node_errors?: Record<string, unknown>
 }
 
+interface ComfyUiSubmitErrorResponse {
+  error?: {
+    type?: string
+    message?: string
+    details?: string
+    extra_info?: Record<string, unknown>
+  }
+  node_errors?: Record<string, unknown>
+}
+
 interface ComfyUiHistoryResponse {
   [promptId: string]: {
     outputs?: Record<string, {
@@ -72,6 +82,11 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
     return workflow && typeof workflow === 'object' ? workflow as Record<string, unknown> : null
   }
 
+  function stripWorkflow(params: Record<string, unknown>) {
+    const { workflow: _workflow, ...rest } = params
+    return rest
+  }
+
   function getComfyMeta(params: Record<string, unknown>) {
     const comfy = params.comfy
     if (!comfy || typeof comfy !== 'object') {
@@ -108,6 +123,20 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
     return false
   }
 
+  function shouldRetryWithDefaultWorkflow(body: string, hadWorkflowOverride: boolean) {
+    if (!hadWorkflowOverride) {
+      return false
+    }
+
+    try {
+      const parsed = JSON.parse(body) as ComfyUiSubmitErrorResponse
+      return parsed.error?.type === 'prompt_outputs_failed_validation'
+    }
+    catch {
+      return false
+    }
+  }
+
   return {
     async handleMessage(event: NsfwImageEvent) {
       const jobId = event.payload.jobId
@@ -173,7 +202,8 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         return
       }
 
-      const workflow = extractWorkflow(job.params) ?? buildDefaultComfyWorkflow(job, env)
+      const workflowOverride = extractWorkflow(job.params)
+      const workflow = workflowOverride ?? buildDefaultComfyWorkflow(job, env)
 
       await mediaService.updateImageJobStatus(jobId, 'submitting', {
         errorMessage: null,
@@ -201,6 +231,85 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
 
       if (!submitResponse.ok) {
         const body = await submitResponse.text()
+        if (shouldRetryWithDefaultWorkflow(body, Boolean(workflowOverride))) {
+          const fallbackParams = stripWorkflow(job.params)
+          const fallbackWorkflow = buildDefaultComfyWorkflow({
+            ...job,
+            params: fallbackParams,
+          }, env)
+
+          await mediaService.updateImageJobStatus(jobId, 'queued', {
+            errorMessage: null,
+            params: fallbackParams,
+          })
+
+          logger.withFields({ jobId, promptId }).warn('Discarding invalid custom ComfyUI workflow override and retrying with default workflow')
+
+          const fallbackResponse = await fetch(new URL('/prompt', env.COMFYUI_BASE_URL), {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({
+              prompt: fallbackWorkflow,
+              prompt_id: promptId,
+              client_id: clientId,
+            }),
+          })
+
+          if (!fallbackResponse.ok) {
+            const fallbackBody = await fallbackResponse.text()
+            await mediaService.updateImageJobStatus(jobId, 'failed', {
+              errorMessage: `ComfyUI fallback submit failed with status ${fallbackResponse.status}: ${fallbackBody}`.slice(0, 2000),
+              params: {
+                ...fallbackParams,
+                workflow: fallbackWorkflow,
+              },
+            })
+            return
+          }
+
+          const fallbackSubmission = await fallbackResponse.json() as ComfyUiPromptSubmission
+          await mediaService.updateImageJobStatus(jobId, 'running', {
+            params: {
+              ...fallbackParams,
+              workflow: fallbackWorkflow,
+              comfy: {
+                ...comfyMeta,
+                promptId: fallbackSubmission.prompt_id ?? promptId,
+                clientId,
+                queueNumber: fallbackSubmission.number,
+                nodeErrors: fallbackSubmission.node_errors,
+                submittedAt: new Date().toISOString(),
+                startedAt: new Date().toISOString(),
+              },
+            },
+          })
+
+          const fallbackHistory = await fetchComfyHistory(promptId)
+          if (!fallbackHistory) {
+            throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
+          }
+
+          const fallbackMediaId = pickFirstImageFilename(fallbackHistory)
+          await mediaService.updateImageJobStatus(jobId, 'done', {
+            resultMediaId: fallbackMediaId ?? job.resultMediaId,
+            params: {
+              ...fallbackParams,
+              workflow: fallbackWorkflow,
+              comfy: {
+                ...comfyMeta,
+                promptId,
+                clientId,
+                completedAt: new Date().toISOString(),
+              },
+            },
+          })
+          await mediaService.updateGalleryItemByImageJobId(jobId, {
+            mediaId: fallbackMediaId ?? undefined,
+            title: job.sceneType ? `${job.sceneType} scene` : undefined,
+          })
+          return
+        }
+
         await mediaService.updateImageJobStatus(jobId, 'failed', {
           errorMessage: `ComfyUI submit failed with status ${submitResponse.status}: ${body}`.slice(0, 2000),
         })
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index b2f90f3aa0..940f9111c5 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -141,6 +141,7 @@ Role:
   - Redis Stream envelope for durable NSFW image execution requests
 - `apps/server/src/services/nsfw-image-consumer-handler.ts`
   - ComfyUI submission and `/history/{prompt_id}` reconciliation logic
+  - discards invalid stale custom workflow overrides and falls back to the server-built default workflow
 - `apps/server/src/services/nsfw-image-workflow.ts`
   - builds a default API-format ComfyUI workflow from prompt, negative prompt, aspect ratio, and checkpoint config
   - currently targets the locally present `ponyDiffusionV6.safetensors` checkpoint by default
@@ -218,6 +219,9 @@ Role:
 - Hermes-backed NSFW image prompt planning
 - server-backed NSFW image job and gallery records
 - Redis-backed NSFW image execution queue
+- fallback from stale custom ComfyUI workflow overrides to the server default workflow
+- validated Windows GPU ComfyUI host on port `8189` using `torch 2.10.0+cu130`
+- validated `sm_120` arch support in the active Windows ComfyUI venv
 - ComfyUI submit/reconcile worker path
 - default API-format ComfyUI workflow generation for NSFW jobs
 

From 27c8bb0704aa9e1c52f5e9b1fd2c4f0279d7f88a Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Wed, 1 Apr 2026 03:03:26 +0200
Subject: [PATCH 17/30] fix: reconcile comfyui execution errors correctly

---
 .../services/nsfw-image-consumer-handler.ts   | 178 +++++++++++++++++-
 docs/content/en/nsfw-companion-index.md       |   4 +
 2 files changed, 176 insertions(+), 6 deletions(-)

diff --git a/apps/server/src/services/nsfw-image-consumer-handler.ts b/apps/server/src/services/nsfw-image-consumer-handler.ts
index 93dd99403a..4d53f03a0e 100644
--- a/apps/server/src/services/nsfw-image-consumer-handler.ts
+++ b/apps/server/src/services/nsfw-image-consumer-handler.ts
@@ -41,6 +41,11 @@ interface ComfyUiHistoryResponse {
   }
 }
 
+interface ParsedComfyHistoryStatus {
+  state: 'running' | 'success' | 'error'
+  errorMessage: string | null
+}
+
 export class JobStillRunningError extends Error {
   constructor(message: string) {
     super(message)
@@ -77,6 +82,42 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
     return null
   }
 
+  function parseHistoryStatus(historyEntry: NonNullable<Awaited<ReturnType<typeof fetchComfyHistory>>>): ParsedComfyHistoryStatus {
+    const status = historyEntry.status
+    const statusStr = typeof status?.status_str === 'string' ? status.status_str : null
+
+    if (statusStr === 'success') {
+      return { state: 'success', errorMessage: null }
+    }
+
+    const messages = Array.isArray(status?.messages) ? status.messages : []
+    for (const message of messages) {
+      if (!Array.isArray(message) || message[0] !== 'execution_error') {
+        continue
+      }
+
+      const payload = message[1]
+      if (!payload || typeof payload !== 'object') {
+        return { state: 'error', errorMessage: 'ComfyUI execution failed' }
+      }
+
+      const record = payload as Record<string, unknown>
+      const nodeType = typeof record.node_type === 'string' ? record.node_type : ''
+      const exceptionMessage = typeof record.exception_message === 'string' ? record.exception_message.trim() : ''
+      const composed = [nodeType, exceptionMessage].filter(Boolean).join(': ').trim()
+      return {
+        state: 'error',
+        errorMessage: composed || 'ComfyUI execution failed',
+      }
+    }
+
+    if (statusStr === 'error') {
+      return { state: 'error', errorMessage: 'ComfyUI execution failed' }
+    }
+
+    return { state: 'running', errorMessage: null }
+  }
+
   function extractWorkflow(params: Record<string, unknown>) {
     const workflow = params.workflow
     return workflow && typeof workflow === 'object' ? workflow as Record<string, unknown> : null
@@ -180,9 +221,50 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
           throw new JobStillRunningError(`ComfyUI job ${promptId} has not produced history yet`)
         }
 
+        const parsedStatus = parseHistoryStatus(history)
+        logger.withFields({ jobId, promptId, parsedStatus }).debug('Resolved ComfyUI history status for existing image job')
+        if (parsedStatus.state === 'running') {
+          throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
+        }
+
+        if (parsedStatus.state === 'error') {
+          logger.withFields({ jobId, promptId, errorMessage: parsedStatus.errorMessage }).warn('Marking image job as failed from ComfyUI history status')
+          await mediaService.updateImageJobStatus(jobId, 'failed', {
+            errorMessage: parsedStatus.errorMessage,
+            params: {
+              ...job.params,
+              comfy: {
+                ...comfyMeta,
+                promptId,
+                clientId,
+                failedAt: new Date().toISOString(),
+              },
+            },
+          })
+          return
+        }
+
         const mediaId = pickFirstImageFilename(history)
+        if (!mediaId) {
+          logger.withFields({ jobId, promptId }).warn('ComfyUI history completed without image output; marking job failed')
+          await mediaService.updateImageJobStatus(jobId, 'failed', {
+            errorMessage: `ComfyUI job ${promptId} completed without image output`,
+            params: {
+              ...job.params,
+              comfy: {
+                ...comfyMeta,
+                promptId,
+                clientId,
+                completedAt: new Date().toISOString(),
+              },
+            },
+          })
+          return
+        }
+
+        logger.withFields({ jobId, promptId, mediaId }).log('Marking image job done from existing ComfyUI history')
         await mediaService.updateImageJobStatus(jobId, 'done', {
-          resultMediaId: mediaId ?? job.resultMediaId,
+          resultMediaId: mediaId,
           errorMessage: null,
           params: {
             ...job.params,
@@ -196,7 +278,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         })
 
         await mediaService.updateGalleryItemByImageJobId(jobId, {
-          mediaId: mediaId ?? undefined,
+          mediaId,
           title: job.sceneType ? `${job.sceneType} scene` : undefined,
         })
         return
@@ -289,9 +371,52 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
             throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
           }
 
+          const fallbackStatus = parseHistoryStatus(fallbackHistory)
+          logger.withFields({ jobId, promptId, parsedStatus: fallbackStatus }).debug('Resolved ComfyUI history status after fallback submit')
+          if (fallbackStatus.state === 'running') {
+            throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
+          }
+
+          if (fallbackStatus.state === 'error') {
+            logger.withFields({ jobId, promptId, errorMessage: fallbackStatus.errorMessage }).warn('Marking image job as failed from fallback ComfyUI history status')
+            await mediaService.updateImageJobStatus(jobId, 'failed', {
+              errorMessage: fallbackStatus.errorMessage,
+              params: {
+                ...fallbackParams,
+                workflow: fallbackWorkflow,
+                comfy: {
+                  ...comfyMeta,
+                  promptId,
+                  clientId,
+                  failedAt: new Date().toISOString(),
+                },
+              },
+            })
+            return
+          }
+
           const fallbackMediaId = pickFirstImageFilename(fallbackHistory)
+          if (!fallbackMediaId) {
+            logger.withFields({ jobId, promptId }).warn('Fallback ComfyUI history completed without image output; marking job failed')
+            await mediaService.updateImageJobStatus(jobId, 'failed', {
+              errorMessage: `ComfyUI job ${promptId} completed without image output`,
+              params: {
+                ...fallbackParams,
+                workflow: fallbackWorkflow,
+                comfy: {
+                  ...comfyMeta,
+                  promptId,
+                  clientId,
+                  completedAt: new Date().toISOString(),
+                },
+              },
+            })
+            return
+          }
+
+          logger.withFields({ jobId, promptId, mediaId: fallbackMediaId }).log('Marking image job done from fallback ComfyUI history')
           await mediaService.updateImageJobStatus(jobId, 'done', {
-            resultMediaId: fallbackMediaId ?? job.resultMediaId,
+            resultMediaId: fallbackMediaId,
             params: {
               ...fallbackParams,
               workflow: fallbackWorkflow,
@@ -304,7 +429,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
             },
           })
           await mediaService.updateGalleryItemByImageJobId(jobId, {
-            mediaId: fallbackMediaId ?? undefined,
+            mediaId: fallbackMediaId,
             title: job.sceneType ? `${job.sceneType} scene` : undefined,
           })
           return
@@ -337,9 +462,50 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
       }
 
+      const parsedStatus = parseHistoryStatus(history)
+      logger.withFields({ jobId, promptId, parsedStatus }).debug('Resolved ComfyUI history status immediately after submit')
+      if (parsedStatus.state === 'running') {
+        throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
+      }
+
+      if (parsedStatus.state === 'error') {
+        logger.withFields({ jobId, promptId, errorMessage: parsedStatus.errorMessage }).warn('Marking image job as failed from immediate ComfyUI history status')
+        await mediaService.updateImageJobStatus(jobId, 'failed', {
+          errorMessage: parsedStatus.errorMessage,
+          params: {
+            ...job.params,
+            comfy: {
+              ...comfyMeta,
+              promptId,
+              clientId,
+              failedAt: new Date().toISOString(),
+            },
+          },
+        })
+        return
+      }
+
       const mediaId = pickFirstImageFilename(history)
+      if (!mediaId) {
+        logger.withFields({ jobId, promptId }).warn('Immediate ComfyUI history completed without image output; marking job failed')
+        await mediaService.updateImageJobStatus(jobId, 'failed', {
+          errorMessage: `ComfyUI job ${promptId} completed without image output`,
+          params: {
+            ...job.params,
+            comfy: {
+              ...comfyMeta,
+              promptId,
+              clientId,
+              completedAt: new Date().toISOString(),
+            },
+          },
+        })
+        return
+      }
+
+      logger.withFields({ jobId, promptId, mediaId }).log('Marking image job done from immediate ComfyUI history')
       await mediaService.updateImageJobStatus(jobId, 'done', {
-        resultMediaId: mediaId ?? job.resultMediaId,
+        resultMediaId: mediaId,
         params: {
           ...job.params,
           comfy: {
@@ -351,7 +517,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         },
       })
       await mediaService.updateGalleryItemByImageJobId(jobId, {
-        mediaId: mediaId ?? undefined,
+        mediaId,
         title: job.sceneType ? `${job.sceneType} scene` : undefined,
       })
     },
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 940f9111c5..0cd73d38db 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -142,6 +142,8 @@ Role:
 - `apps/server/src/services/nsfw-image-consumer-handler.ts`
   - ComfyUI submission and `/history/{prompt_id}` reconciliation logic
   - discards invalid stale custom workflow overrides and falls back to the server-built default workflow
+  - treats ComfyUI `history.status=error` as `failed` instead of `done`
+  - only sets `resultMediaId` and gallery `mediaId` when actual image output exists
 - `apps/server/src/services/nsfw-image-workflow.ts`
   - builds a default API-format ComfyUI workflow from prompt, negative prompt, aspect ratio, and checkpoint config
   - currently targets the locally present `ponyDiffusionV6.safetensors` checkpoint by default
@@ -222,6 +224,8 @@ Role:
 - fallback from stale custom ComfyUI workflow overrides to the server default workflow
 - validated Windows GPU ComfyUI host on port `8189` using `torch 2.10.0+cu130`
 - validated `sm_120` arch support in the active Windows ComfyUI venv
+- hardened ComfyUI history reconciliation so errored executions no longer get marked as successful image jobs
+- validated live: a ComfyUI GPU `execution_error` now lands as `image_jobs.status=failed` with the upstream error text, while `resultMediaId` and gallery `mediaId` stay empty
 - ComfyUI submit/reconcile worker path
 - default API-format ComfyUI workflow generation for NSFW jobs
 

From 2e2de3821e5d1faa58387e2dcc34957383d3dff3 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Wed, 1 Apr 2026 03:07:17 +0200
Subject: [PATCH 18/30] feat: enrich comfy execution metadata

---
 .../services/nsfw-image-consumer-handler.ts   | 101 +++++++++++++-----
 docs/content/en/nsfw-companion-index.md       |   1 +
 2 files changed, 75 insertions(+), 27 deletions(-)

diff --git a/apps/server/src/services/nsfw-image-consumer-handler.ts b/apps/server/src/services/nsfw-image-consumer-handler.ts
index 4d53f03a0e..01013518e1 100644
--- a/apps/server/src/services/nsfw-image-consumer-handler.ts
+++ b/apps/server/src/services/nsfw-image-consumer-handler.ts
@@ -44,6 +44,8 @@ interface ComfyUiHistoryResponse {
 interface ParsedComfyHistoryStatus {
   state: 'running' | 'success' | 'error'
   errorMessage: string | null
+  errorType?: string | null
+  nodeType?: string | null
 }
 
 export class JobStillRunningError extends Error {
@@ -98,24 +100,63 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
 
       const payload = message[1]
       if (!payload || typeof payload !== 'object') {
-        return { state: 'error', errorMessage: 'ComfyUI execution failed' }
+        return { state: 'error', errorMessage: 'ComfyUI execution failed', errorType: null, nodeType: null }
       }
 
       const record = payload as Record<string, unknown>
       const nodeType = typeof record.node_type === 'string' ? record.node_type : ''
       const exceptionMessage = typeof record.exception_message === 'string' ? record.exception_message.trim() : ''
+      const exceptionType = typeof record.exception_type === 'string' ? record.exception_type : ''
       const composed = [nodeType, exceptionMessage].filter(Boolean).join(': ').trim()
       return {
         state: 'error',
         errorMessage: composed || 'ComfyUI execution failed',
+        errorType: exceptionType || null,
+        nodeType: nodeType || null,
       }
     }
 
     if (statusStr === 'error') {
-      return { state: 'error', errorMessage: 'ComfyUI execution failed' }
+      return { state: 'error', errorMessage: 'ComfyUI execution failed', errorType: null, nodeType: null }
     }
 
-    return { state: 'running', errorMessage: null }
+    return { state: 'running', errorMessage: null, errorType: null, nodeType: null }
+  }
+
+  function buildFailedComfyMeta(comfyMeta: Record<string, unknown>, input: {
+    promptId: string
+    clientId: string
+    errorMessage: string | null
+    errorType?: string | null
+    nodeType?: string | null
+  }) {
+    return {
+      ...comfyMeta,
+      promptId: input.promptId,
+      clientId: input.clientId,
+      executionStatus: 'error',
+      errorMessage: input.errorMessage,
+      errorType: input.errorType ?? null,
+      errorNodeType: input.nodeType ?? null,
+      historySeenAt: new Date().toISOString(),
+      failedAt: new Date().toISOString(),
+    }
+  }
+
+  function buildSuccessfulComfyMeta(comfyMeta: Record<string, unknown>, input: {
+    promptId: string
+    clientId: string
+    mediaId: string
+  }) {
+    return {
+      ...comfyMeta,
+      promptId: input.promptId,
+      clientId: input.clientId,
+      executionStatus: 'success',
+      outputMediaId: input.mediaId,
+      historySeenAt: new Date().toISOString(),
+      completedAt: new Date().toISOString(),
+    }
   }
 
   function extractWorkflow(params: Record<string, unknown>) {
@@ -233,12 +274,13 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
             errorMessage: parsedStatus.errorMessage,
             params: {
               ...job.params,
-              comfy: {
-                ...comfyMeta,
+              comfy: buildFailedComfyMeta(comfyMeta, {
                 promptId,
                 clientId,
-                failedAt: new Date().toISOString(),
-              },
+                errorMessage: parsedStatus.errorMessage,
+                errorType: parsedStatus.errorType,
+                nodeType: parsedStatus.nodeType,
+              }),
             },
           })
           return
@@ -255,6 +297,8 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
                 ...comfyMeta,
                 promptId,
                 clientId,
+                executionStatus: 'missing_output',
+                historySeenAt: new Date().toISOString(),
                 completedAt: new Date().toISOString(),
               },
             },
@@ -268,12 +312,11 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
           errorMessage: null,
           params: {
             ...job.params,
-            comfy: {
-              ...comfyMeta,
+            comfy: buildSuccessfulComfyMeta(comfyMeta, {
               promptId,
               clientId,
-              completedAt: new Date().toISOString(),
-            },
+              mediaId,
+            }),
           },
         })
 
@@ -384,12 +427,13 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
               params: {
                 ...fallbackParams,
                 workflow: fallbackWorkflow,
-                comfy: {
-                  ...comfyMeta,
+                comfy: buildFailedComfyMeta(comfyMeta, {
                   promptId,
                   clientId,
-                  failedAt: new Date().toISOString(),
-                },
+                  errorMessage: fallbackStatus.errorMessage,
+                  errorType: fallbackStatus.errorType,
+                  nodeType: fallbackStatus.nodeType,
+                }),
               },
             })
             return
@@ -407,6 +451,8 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
                   ...comfyMeta,
                   promptId,
                   clientId,
+                  executionStatus: 'missing_output',
+                  historySeenAt: new Date().toISOString(),
                   completedAt: new Date().toISOString(),
                 },
               },
@@ -420,12 +466,11 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
             params: {
               ...fallbackParams,
               workflow: fallbackWorkflow,
-              comfy: {
-                ...comfyMeta,
+              comfy: buildSuccessfulComfyMeta(comfyMeta, {
                 promptId,
                 clientId,
-                completedAt: new Date().toISOString(),
-              },
+                mediaId: fallbackMediaId,
+              }),
             },
           })
           await mediaService.updateGalleryItemByImageJobId(jobId, {
@@ -474,12 +519,13 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
           errorMessage: parsedStatus.errorMessage,
           params: {
             ...job.params,
-            comfy: {
-              ...comfyMeta,
+            comfy: buildFailedComfyMeta(comfyMeta, {
               promptId,
               clientId,
-              failedAt: new Date().toISOString(),
-            },
+              errorMessage: parsedStatus.errorMessage,
+              errorType: parsedStatus.errorType,
+              nodeType: parsedStatus.nodeType,
+            }),
           },
         })
         return
@@ -496,6 +542,8 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
               ...comfyMeta,
               promptId,
               clientId,
+              executionStatus: 'missing_output',
+              historySeenAt: new Date().toISOString(),
               completedAt: new Date().toISOString(),
             },
           },
@@ -508,12 +556,11 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         resultMediaId: mediaId,
         params: {
           ...job.params,
-          comfy: {
-            ...comfyMeta,
+          comfy: buildSuccessfulComfyMeta(comfyMeta, {
             promptId,
             clientId,
-            completedAt: new Date().toISOString(),
-          },
+            mediaId,
+          }),
         },
       })
       await mediaService.updateGalleryItemByImageJobId(jobId, {
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 0cd73d38db..d33eee6a80 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -144,6 +144,7 @@ Role:
   - discards invalid stale custom workflow overrides and falls back to the server-built default workflow
   - treats ComfyUI `history.status=error` as `failed` instead of `done`
   - only sets `resultMediaId` and gallery `mediaId` when actual image output exists
+  - now records explicit `executionStatus`, `errorType`, `errorNodeType`, `historySeenAt`, and `outputMediaId` metadata under `params.comfy`
 - `apps/server/src/services/nsfw-image-workflow.ts`
   - builds a default API-format ComfyUI workflow from prompt, negative prompt, aspect ratio, and checkpoint config
   - currently targets the locally present `ponyDiffusionV6.safetensors` checkpoint by default

From 6ffd7cbec8f4e276fdf7861af99f077699ab8300 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Wed, 1 Apr 2026 03:09:33 +0200
Subject: [PATCH 19/30] feat: add comfyui fallback host support

---
 apps/server/src/libs/env.ts                   |  1 +
 .../services/nsfw-image-consumer-handler.ts   | 77 +++++++++++++++++--
 docs/content/en/nsfw-companion-index.md       |  1 +
 3 files changed, 73 insertions(+), 6 deletions(-)

diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index e7ec6a3eab..eb3c40ba5e 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -63,6 +63,7 @@ const EnvSchema = object({
   NSFW_IMAGE_EVENTS_BLOCK_MS: optionalIntegerFromString(5000, 'NSFW_IMAGE_EVENTS_BLOCK_MS', 1),
   NSFW_IMAGE_EVENTS_MIN_IDLE_MS: optionalIntegerFromString(30000, 'NSFW_IMAGE_EVENTS_MIN_IDLE_MS', 1),
   COMFYUI_BASE_URL: optional(string(), 'http://127.0.0.1:8188'),
+  COMFYUI_FALLBACK_BASE_URL: optional(string()),
   COMFYUI_DEFAULT_CHECKPOINT: optional(string(), 'ponyDiffusionV6.safetensors'),
   COMFYUI_DEFAULT_STEPS: optionalIntegerFromString(24, 'COMFYUI_DEFAULT_STEPS', 1),
   COMFYUI_DEFAULT_CFG: optionalNumberFromString(8, 'COMFYUI_DEFAULT_CFG', 1, 30),
diff --git a/apps/server/src/services/nsfw-image-consumer-handler.ts b/apps/server/src/services/nsfw-image-consumer-handler.ts
index 01013518e1..d5a182379d 100644
--- a/apps/server/src/services/nsfw-image-consumer-handler.ts
+++ b/apps/server/src/services/nsfw-image-consumer-handler.ts
@@ -56,8 +56,8 @@ export class JobStillRunningError extends Error {
 }
 
 export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, env: Env) {
-  async function fetchComfyHistory(promptId: string) {
-    const response = await fetch(new URL(`/history/${promptId}`, env.COMFYUI_BASE_URL))
+  async function fetchComfyHistory(promptId: string, baseUrl = env.COMFYUI_BASE_URL) {
+    const response = await fetch(new URL(`/history/${promptId}`, baseUrl))
     if (response.status === 404) {
       return null
     }
@@ -123,6 +123,27 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
     return { state: 'running', errorMessage: null, errorType: null, nodeType: null }
   }
 
+  function shouldRetryOnFallback(parsedStatus: ParsedComfyHistoryStatus, comfyMeta: Record<string, unknown>) {
+    if (!env.COMFYUI_FALLBACK_BASE_URL) {
+      return false
+    }
+
+    if (typeof comfyMeta.fallbackUsed === 'boolean' && comfyMeta.fallbackUsed) {
+      return false
+    }
+
+    const error = (parsedStatus.errorMessage ?? '').toLowerCase()
+    return error.includes('no kernel image is available for execution on the device')
+  }
+
+  function resolveComfyBaseUrl(comfyMeta: Record<string, unknown>) {
+    if (typeof comfyMeta.baseUrl === 'string' && comfyMeta.baseUrl) {
+      return comfyMeta.baseUrl
+    }
+
+    return env.COMFYUI_BASE_URL
+  }
+
   function buildFailedComfyMeta(comfyMeta: Record<string, unknown>, input: {
     promptId: string
     clientId: string
@@ -235,9 +256,10 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
       const comfyMeta = getComfyMeta(job.params)
       const promptId = typeof comfyMeta.promptId === 'string' ? comfyMeta.promptId : job.id
       const clientId = typeof comfyMeta.clientId === 'string' ? comfyMeta.clientId : `airi-${job.userId}`
+      const comfyBaseUrl = resolveComfyBaseUrl(comfyMeta)
 
       if (job.status === 'running' || job.status === 'submitting') {
-        const history = await fetchComfyHistory(promptId)
+        const history = await fetchComfyHistory(promptId, comfyBaseUrl)
         if (!history) {
           if (isTimedOut(job.status, comfyMeta)) {
             const timeoutMs = job.status === 'submitting'
@@ -269,6 +291,26 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         }
 
         if (parsedStatus.state === 'error') {
+          if (shouldRetryOnFallback(parsedStatus, comfyMeta)) {
+            await mediaService.updateImageJobStatus(jobId, 'queued', {
+              errorMessage: null,
+              params: {
+                ...job.params,
+                comfy: {
+                  ...comfyMeta,
+                  baseUrl: env.COMFYUI_FALLBACK_BASE_URL,
+                  fallbackUsed: true,
+                  fallbackReason: parsedStatus.errorMessage,
+                  fallbackQueuedAt: new Date().toISOString(),
+                  promptId: job.id,
+                  clientId,
+                },
+              },
+            })
+            logger.withFields({ jobId, promptId, fallbackBaseUrl: env.COMFYUI_FALLBACK_BASE_URL }).warn('Retrying image job on ComfyUI fallback host after GPU kernel failure')
+            return
+          }
+
           logger.withFields({ jobId, promptId, errorMessage: parsedStatus.errorMessage }).warn('Marking image job as failed from ComfyUI history status')
           await mediaService.updateImageJobStatus(jobId, 'failed', {
             errorMessage: parsedStatus.errorMessage,
@@ -337,6 +379,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
           workflow,
           comfy: {
             ...comfyMeta,
+            baseUrl: comfyBaseUrl,
             promptId,
             clientId,
             submittedAt: new Date().toISOString(),
@@ -344,7 +387,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         },
       })
 
-      const submitResponse = await fetch(new URL('/prompt', env.COMFYUI_BASE_URL), {
+      const submitResponse = await fetch(new URL('/prompt', comfyBaseUrl), {
         method: 'POST',
         headers: { 'content-type': 'application/json' },
         body: JSON.stringify({
@@ -399,6 +442,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
               workflow: fallbackWorkflow,
               comfy: {
                 ...comfyMeta,
+                baseUrl: env.COMFYUI_FALLBACK_BASE_URL ?? comfyBaseUrl,
                 promptId: fallbackSubmission.prompt_id ?? promptId,
                 clientId,
                 queueNumber: fallbackSubmission.number,
@@ -409,7 +453,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
             },
           })
 
-          const fallbackHistory = await fetchComfyHistory(promptId)
+          const fallbackHistory = await fetchComfyHistory(promptId, env.COMFYUI_FALLBACK_BASE_URL ?? comfyBaseUrl)
           if (!fallbackHistory) {
             throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
           }
@@ -492,6 +536,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
           ...job.params,
           comfy: {
             ...comfyMeta,
+            baseUrl: comfyBaseUrl,
             promptId: submission.prompt_id ?? promptId,
             clientId,
             queueNumber: submission.number,
@@ -502,7 +547,7 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
         },
       })
 
-      const history = await fetchComfyHistory(promptId)
+      const history = await fetchComfyHistory(promptId, comfyBaseUrl)
       if (!history) {
         throw new JobStillRunningError(`ComfyUI job ${promptId} is still running`)
       }
@@ -514,6 +559,26 @@ export function createNsfwImageConsumerHandler(mediaService: NsfwMediaService, e
       }
 
       if (parsedStatus.state === 'error') {
+        if (shouldRetryOnFallback(parsedStatus, comfyMeta)) {
+          await mediaService.updateImageJobStatus(jobId, 'queued', {
+            errorMessage: null,
+            params: {
+              ...job.params,
+              comfy: {
+                ...comfyMeta,
+                baseUrl: env.COMFYUI_FALLBACK_BASE_URL,
+                fallbackUsed: true,
+                fallbackReason: parsedStatus.errorMessage,
+                fallbackQueuedAt: new Date().toISOString(),
+                promptId: job.id,
+                clientId,
+              },
+            },
+          })
+          logger.withFields({ jobId, promptId, fallbackBaseUrl: env.COMFYUI_FALLBACK_BASE_URL }).warn('Retrying image job on ComfyUI fallback host after immediate GPU kernel failure')
+          return
+        }
+
         logger.withFields({ jobId, promptId, errorMessage: parsedStatus.errorMessage }).warn('Marking image job as failed from immediate ComfyUI history status')
         await mediaService.updateImageJobStatus(jobId, 'failed', {
           errorMessage: parsedStatus.errorMessage,
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index d33eee6a80..298a06fce9 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -145,6 +145,7 @@ Role:
   - treats ComfyUI `history.status=error` as `failed` instead of `done`
   - only sets `resultMediaId` and gallery `mediaId` when actual image output exists
   - now records explicit `executionStatus`, `errorType`, `errorNodeType`, `historySeenAt`, and `outputMediaId` metadata under `params.comfy`
+  - can automatically requeue known GPU kernel failures to `COMFYUI_FALLBACK_BASE_URL` when configured
 - `apps/server/src/services/nsfw-image-workflow.ts`
   - builds a default API-format ComfyUI workflow from prompt, negative prompt, aspect ratio, and checkpoint config
   - currently targets the locally present `ponyDiffusionV6.safetensors` checkpoint by default

From c5ccd9346ffda597aba572dacf2a66fb3780f14f Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Wed, 1 Apr 2026 03:44:21 +0200
Subject: [PATCH 20/30] chore: add .env to gitignore

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index ff1ce700ab..1ab469839b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -126,3 +126,4 @@ apps/stage-pocket/ios/buildServer.json
 .ghfs/
 .docs/superpowers
 apps/stage-tamagotchi/electron.vite.config.*.mjs
+.env

From bacd366fcb7e46fb2e9a30f8ac959126d834e5da Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Wed, 1 Apr 2026 04:12:23 +0200
Subject: [PATCH 21/30] feat: validate sd-turbo cpu fallback path

---
 apps/server/src/libs/env.ts                   |  4 ++
 .../src/services/nsfw-image-workflow.ts       | 60 +++++++++++++++++--
 docs/content/en/nsfw-companion-index.md       | 29 ++++++---
 3 files changed, 78 insertions(+), 15 deletions(-)

diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index eb3c40ba5e..0f27774989 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -65,9 +65,13 @@ const EnvSchema = object({
   COMFYUI_BASE_URL: optional(string(), 'http://127.0.0.1:8188'),
   COMFYUI_FALLBACK_BASE_URL: optional(string()),
   COMFYUI_DEFAULT_CHECKPOINT: optional(string(), 'ponyDiffusionV6.safetensors'),
+  COMFYUI_FALLBACK_CHECKPOINT: optional(string(), 'sd_turbo.safetensors'),
   COMFYUI_DEFAULT_STEPS: optionalIntegerFromString(24, 'COMFYUI_DEFAULT_STEPS', 1),
+  COMFYUI_FALLBACK_STEPS: optionalIntegerFromString(2, 'COMFYUI_FALLBACK_STEPS', 1),
   COMFYUI_DEFAULT_CFG: optionalNumberFromString(8, 'COMFYUI_DEFAULT_CFG', 1, 30),
+  COMFYUI_FALLBACK_CFG: optionalNumberFromString(1, 'COMFYUI_FALLBACK_CFG', 1, 30),
   COMFYUI_MAX_DIMENSION: optionalIntegerFromString(1216, 'COMFYUI_MAX_DIMENSION', 64),
+  COMFYUI_FALLBACK_MAX_DIMENSION: optionalIntegerFromString(384, 'COMFYUI_FALLBACK_MAX_DIMENSION', 64),
   COMFYUI_SUBMIT_TIMEOUT_MS: optionalIntegerFromString(120000, 'COMFYUI_SUBMIT_TIMEOUT_MS', 1000),
   COMFYUI_RUNNING_TIMEOUT_MS: optionalIntegerFromString(900000, 'COMFYUI_RUNNING_TIMEOUT_MS', 1000),
   COMFYUI_DEFAULT_LORA: optional(string(), 'pony_realism.safetensors'),
diff --git a/apps/server/src/services/nsfw-image-workflow.ts b/apps/server/src/services/nsfw-image-workflow.ts
index d7ed41e1ca..3eb96fed95 100644
--- a/apps/server/src/services/nsfw-image-workflow.ts
+++ b/apps/server/src/services/nsfw-image-workflow.ts
@@ -8,6 +8,15 @@ interface PlannerParams {
   aspectRatio?: string
 }
 
+interface WorkflowProfile {
+  checkpoint: string
+  steps: number
+  cfg: number
+  maxDimension: number
+  primaryLoraEnabled: boolean
+  secondaryLoraEnabled: boolean
+}
+
 type ComfyPromptWorkflow = Record<string, {
   class_type: string
   inputs: Record<string, unknown>
@@ -70,10 +79,49 @@ function workflowPrefix(job: ImageJob, planner: PlannerParams) {
     .join('-')
 }
 
+function getComfyMeta(params: Record<string, unknown>) {
+  const comfy = params.comfy
+  if (!comfy || typeof comfy !== 'object' || Array.isArray(comfy)) {
+    return {}
+  }
+
+  return comfy as Record<string, unknown>
+}
+
+function resolveWorkflowProfile(job: ImageJob, env: Env): WorkflowProfile {
+  const comfyMeta = getComfyMeta(job.params)
+  const isFallback = Boolean(
+    env.COMFYUI_FALLBACK_BASE_URL
+    && typeof comfyMeta.baseUrl === 'string'
+    && comfyMeta.baseUrl === env.COMFYUI_FALLBACK_BASE_URL,
+  )
+
+  if (isFallback) {
+    return {
+      checkpoint: env.COMFYUI_FALLBACK_CHECKPOINT || env.COMFYUI_DEFAULT_CHECKPOINT,
+      steps: env.COMFYUI_FALLBACK_STEPS,
+      cfg: env.COMFYUI_FALLBACK_CFG,
+      maxDimension: env.COMFYUI_FALLBACK_MAX_DIMENSION,
+      primaryLoraEnabled: false,
+      secondaryLoraEnabled: false,
+    }
+  }
+
+  return {
+    checkpoint: env.COMFYUI_DEFAULT_CHECKPOINT,
+    steps: env.COMFYUI_DEFAULT_STEPS,
+    cfg: env.COMFYUI_DEFAULT_CFG,
+    maxDimension: env.COMFYUI_MAX_DIMENSION,
+    primaryLoraEnabled: Boolean(env.COMFYUI_DEFAULT_LORA?.trim()),
+    secondaryLoraEnabled: Boolean(env.COMFYUI_SECONDARY_LORA?.trim()),
+  }
+}
+
 export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptWorkflow {
   const planner = parsePlannerParams(job.params)
   const baseDimensions = dimensionsFromAspectRatio(planner.aspectRatio)
-  const { width, height } = clampDimensions(baseDimensions.width, baseDimensions.height, env.COMFYUI_MAX_DIMENSION)
+  const profile = resolveWorkflowProfile(job, env)
+  const { width, height } = clampDimensions(baseDimensions.width, baseDimensions.height, profile.maxDimension)
   const positiveText = [
     job.prompt,
     planner.style,
@@ -84,8 +132,8 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
   const seedSource = Number.parseInt(job.id.replace(/\D/g, '').slice(0, 9), 10)
   const seed = Number.isFinite(seedSource) ? seedSource : Date.now() % 2147483647
 
-  const primaryLoraEnabled = Boolean(env.COMFYUI_DEFAULT_LORA?.trim())
-  const secondaryLoraEnabled = Boolean(env.COMFYUI_SECONDARY_LORA?.trim())
+  const primaryLoraEnabled = profile.primaryLoraEnabled
+  const secondaryLoraEnabled = profile.secondaryLoraEnabled
 
   const modelSource: [string, number] = secondaryLoraEnabled
     ? ['11', 0]
@@ -102,7 +150,7 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
     3: {
       class_type: 'KSampler',
       inputs: {
-        cfg: env.COMFYUI_DEFAULT_CFG,
+        cfg: profile.cfg,
         denoise: 1,
         latent_image: ['5', 0],
         model: modelSource,
@@ -111,13 +159,13 @@ export function buildDefaultComfyWorkflow(job: ImageJob, env: Env): ComfyPromptW
         sampler_name: 'euler',
         scheduler: 'normal',
         seed,
-        steps: env.COMFYUI_DEFAULT_STEPS,
+        steps: profile.steps,
       },
     },
     4: {
       class_type: 'CheckpointLoaderSimple',
       inputs: {
-        ckpt_name: env.COMFYUI_DEFAULT_CHECKPOINT,
+        ckpt_name: profile.checkpoint,
       },
     },
     5: {
diff --git a/docs/content/en/nsfw-companion-index.md b/docs/content/en/nsfw-companion-index.md
index 298a06fce9..866941017d 100644
--- a/docs/content/en/nsfw-companion-index.md
+++ b/docs/content/en/nsfw-companion-index.md
@@ -230,29 +230,40 @@ Role:
 - validated live: a ComfyUI GPU `execution_error` now lands as `image_jobs.status=failed` with the upstream error text, while `resultMediaId` and gallery `mediaId` stay empty
 - ComfyUI submit/reconcile worker path
 - default API-format ComfyUI workflow generation for NSFW jobs
+- validated Docker CPU fallback against the local Linux ComfyUI model set
+- validated end-to-end fallback reconciliation using `sd_turbo.safetensors` on `http://localhost:8189`
 
 ### Live Runtime Status
 
 - Local ComfyUI now starts and serves `http://127.0.0.1:8188`
 - Local Postgres and Redis now run through `apps/server/docker-compose.yml`
 - `nsfw-image-consumer` now connects to local Postgres and Redis and applies migrations successfully
-- A real runtime test job was accepted by ComfyUI and appears in `queue_running`
-- A second ultra-light CPU smoke test was also accepted with:
+- The Docker CPU fallback now mounts the local Linux ComfyUI models instead of the incompatible Windows fallback set
+- The Docker CPU fallback now runs with `--cpu --disable-all-custom-nodes`
+- A real CPU fallback smoke render completed with:
   - `sd_turbo.safetensors`
-  - `4` steps
-  - `512x512`
+  - `2` steps
+  - `384x384`
   - no LoRA chain
-- Current end-to-end runtime path is proven through:
+- Current end-to-end fallback runtime path is proven through:
   - AIRI job record
   - Redis event
   - worker pickup
-  - ComfyUI prompt submission
-  - ComfyUI queue visibility
-- Final image completion is still slow in the current `--cpu` ComfyUI run, so completion timing and gallery reconciliation are not yet representative of the intended GPU path
+  - ComfyUI prompt submission on `http://localhost:8189`
+  - ComfyUI `history.status=success`
+  - `image_jobs.status=done`
+  - `image_jobs.result_media_id`
+  - `gallery_items.media_id`
+- The validated output filename from the fallback path is `airi-nsfw-runtime-character-soft_00001_.png`
 - The default workflow now supports env-level smoke-test tuning through:
   - `COMFYUI_DEFAULT_STEPS`
   - `COMFYUI_DEFAULT_CFG`
   - `COMFYUI_MAX_DIMENSION`
+- The CPU fallback now also supports env-level tuning through:
+  - `COMFYUI_FALLBACK_CHECKPOINT`
+  - `COMFYUI_FALLBACK_STEPS`
+  - `COMFYUI_FALLBACK_CFG`
+  - `COMFYUI_FALLBACK_MAX_DIMENSION`
 - Stuck ComfyUI jobs can now fail cleanly through:
   - `COMFYUI_SUBMIT_TIMEOUT_MS`
   - `COMFYUI_RUNNING_TIMEOUT_MS`
@@ -263,7 +274,7 @@ Role:
 - quality judge beyond simple heuristic flags
 - premium gating for NSFW media actions
 - GPU-backed ComfyUI runtime validation
-- final image completion and gallery reconciliation validation on a non-CPU render path
+- faster non-CPU render validation on the Windows GPU path
 - actual model wiring to `Hermes-4.3-36B`, `Grok 4.20`, and `GPT-5 mini`
 - build, typecheck, and tests once dependencies are installed
 

From bd52ee0d36b77d42b937d4cd7e722349e3d74503 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Fri, 3 Apr 2026 03:09:55 +0200
Subject: [PATCH 22/30] fix: use process.on instead of named export for Node 22
 compatibility

The 'on' function is not a named export from 'node:process' in Node 22.
Changed to use process.on() directly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 packages/server-runtime/src/bin/run.ts |  6 ++--
 pnpm-lock.yaml                         | 46 +++++++++++++++++---------
 2 files changed, 33 insertions(+), 19 deletions(-)

diff --git a/packages/server-runtime/src/bin/run.ts b/packages/server-runtime/src/bin/run.ts
index 3cde056ec2..1d4d04a6d0 100644
--- a/packages/server-runtime/src/bin/run.ts
+++ b/packages/server-runtime/src/bin/run.ts
@@ -1,6 +1,6 @@
 #!/usr/bin/env tsx
 
-import { env, exit, on } from 'node:process'
+import process, { env, exit } from 'node:process'
 
 import { createServer } from '../server'
 
@@ -18,7 +18,7 @@ async function shutdown() {
   exit(0)
 }
 
-on('SIGINT', shutdown)
-on('SIGTERM', shutdown)
+process.on('SIGINT', shutdown)
+process.on('SIGTERM', shutdown)
 
 server.start()
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 1c265e96ff..0c41d153ae 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -2286,6 +2286,10 @@ importers:
         version: 2.2.6
 
   packages/server-schema:
+    dependencies:
+      valibot:
+        specifier: 'catalog:'
+        version: 1.2.0(typescript@5.9.3)
     devDependencies:
       '@proj-airi/unplugin-drizzle-orm-migrations':
         specifier: 'catalog:'
@@ -2617,6 +2621,9 @@ importers:
       '@proj-airi/server-sdk':
         specifier: workspace:^
         version: link:../server-sdk
+      '@proj-airi/server-sdk-shared':
+        specifier: workspace:^
+        version: link:../server-sdk-shared
       '@proj-airi/stage-shared':
         specifier: workspace:^
         version: link:../stage-shared
@@ -18869,26 +18876,33 @@ snapshots:
     optionalDependencies:
       drizzle-orm: 0.45.1(@electric-sql/pglite@0.4.1)(@opentelemetry/api@1.9.1)(@prisma/client@5.22.0)(@types/pg@8.20.0)(better-sqlite3@12.5.0)(kysely@0.28.14)(pg@8.20.0)(postgres@3.4.8)
 
-  '@better-auth/kysely-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(kysely@0.28.14)':
+  '@better-auth/drizzle-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(drizzle-orm@0.45.1(@electric-sql/pglite@0.4.1)(@opentelemetry/api@1.9.1)(@prisma/client@5.22.0)(@types/pg@8.20.0)(better-sqlite3@12.5.0)(kysely@0.28.14)(pg@8.20.0)(postgres@3.4.8))':
     dependencies:
-      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
+      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
+      '@better-auth/utils': 0.3.1
+    optionalDependencies:
+      drizzle-orm: 0.45.1(@electric-sql/pglite@0.4.1)(@opentelemetry/api@1.9.1)(@prisma/client@5.22.0)(@types/pg@8.20.0)(better-sqlite3@12.5.0)(kysely@0.28.14)(pg@8.20.0)(postgres@3.4.8)
+
+  '@better-auth/kysely-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(kysely@0.28.14)':
+    dependencies:
+      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
       '@better-auth/utils': 0.3.1
     optionalDependencies:
       kysely: 0.28.14
 
-  '@better-auth/memory-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)':
+  '@better-auth/memory-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)':
     dependencies:
-      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
+      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
       '@better-auth/utils': 0.3.1
 
-  '@better-auth/mongo-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)':
+  '@better-auth/mongo-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)':
     dependencies:
-      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
+      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
       '@better-auth/utils': 0.3.1
 
-  '@better-auth/prisma-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(@prisma/client@5.22.0)':
+  '@better-auth/prisma-adapter@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(@prisma/client@5.22.0)':
     dependencies:
-      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
+      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
       '@better-auth/utils': 0.3.1
     optionalDependencies:
       '@prisma/client': 5.22.0
@@ -18899,9 +18913,9 @@ snapshots:
       '@better-auth/utils': 0.3.0
       '@better-fetch/fetch': 1.1.21
 
-  '@better-auth/telemetry@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))':
+  '@better-auth/telemetry@1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))':
     dependencies:
-      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
+      '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
       '@better-auth/utils': 0.3.1
       '@better-fetch/fetch': 1.1.21
 
@@ -25206,12 +25220,12 @@ snapshots:
   better-auth@1.5.6(@opentelemetry/api@1.9.1)(@prisma/client@5.22.0)(better-sqlite3@12.5.0)(drizzle-kit@0.31.10)(drizzle-orm@0.45.1(@electric-sql/pglite@0.4.1)(@opentelemetry/api@1.9.1)(@prisma/client@5.22.0)(@types/pg@8.20.0)(better-sqlite3@12.5.0)(kysely@0.28.14)(pg@8.20.0)(postgres@3.4.8))(pg@8.20.0)(react@19.2.3)(vitest@4.1.1)(vue@3.5.30(typescript@5.9.3)):
     dependencies:
       '@better-auth/core': 1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1)
-      '@better-auth/drizzle-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(drizzle-orm@0.45.1(@electric-sql/pglite@0.4.1)(@opentelemetry/api@1.9.1)(@prisma/client@5.22.0)(@types/pg@8.20.0)(better-sqlite3@12.5.0)(kysely@0.28.14)(pg@8.20.0)(postgres@3.4.8))
-      '@better-auth/kysely-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(kysely@0.28.14)
-      '@better-auth/memory-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)
-      '@better-auth/mongo-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)
-      '@better-auth/prisma-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(@prisma/client@5.22.0)
-      '@better-auth/telemetry': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.1.8(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))
+      '@better-auth/drizzle-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(drizzle-orm@0.45.1(@electric-sql/pglite@0.4.1)(@opentelemetry/api@1.9.1)(@prisma/client@5.22.0)(@types/pg@8.20.0)(better-sqlite3@12.5.0)(kysely@0.28.14)(pg@8.20.0)(postgres@3.4.8))
+      '@better-auth/kysely-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(kysely@0.28.14)
+      '@better-auth/memory-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)
+      '@better-auth/mongo-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)
+      '@better-auth/prisma-adapter': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))(@better-auth/utils@0.3.1)(@prisma/client@5.22.0)
+      '@better-auth/telemetry': 1.5.6(@better-auth/core@1.5.6(@better-auth/utils@0.3.1)(@better-fetch/fetch@1.1.21)(@opentelemetry/api@1.9.1)(better-call@1.3.2(zod@4.3.6))(jose@6.1.3)(kysely@0.28.14)(nanostores@1.1.1))
       '@better-auth/utils': 0.3.1
       '@better-fetch/fetch': 1.1.21
       '@noble/ciphers': 2.1.1

From 1591b2fa7eb7db4e569f5abd7a48e654ba57cf83 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Fri, 3 Apr 2026 06:16:21 +0200
Subject: [PATCH 23/30] fix: update pnpm-lock.yaml for server-schema valibot
 dependency

Adds missing valibot@catalog: specifier to lockfile for
packages/server-schema, fixing CI frozen-lockfile failures.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 pnpm-lock.yaml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 4152eee1f8..08b123da69 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -2541,6 +2541,10 @@ importers:
         version: 2.2.6
 
   packages/server-schema:
+    dependencies:
+      valibot:
+        specifier: 'catalog:'
+        version: 1.2.0(typescript@5.9.3)
     devDependencies:
       '@proj-airi/unplugin-drizzle-orm-migrations':
         specifier: 'catalog:'
@@ -2878,6 +2882,9 @@ importers:
       '@proj-airi/server-sdk':
         specifier: workspace:^
         version: link:../server-sdk
+      '@proj-airi/server-sdk-shared':
+        specifier: workspace:^
+        version: link:../server-sdk-shared
       '@proj-airi/stage-shared':
         specifier: workspace:^
         version: link:../stage-shared

From 238373b43ae5a5a4e390c204051ba60dc1dda31e Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Fri, 3 Apr 2026 06:20:43 +0200
Subject: [PATCH 24/30] fix: resolve TypeScript errors from merge

- Remove duplicate db property in buildApp call
- Remove unused integer import from nsfw-media schema
- Add missing nsfwMediaService and nsfwImageMq to test deps

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 apps/server/src/app.test.ts           | 2 ++
 apps/server/src/app.ts                | 1 -
 apps/server/src/schemas/nsfw-media.ts | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/apps/server/src/app.test.ts b/apps/server/src/app.test.ts
index 5c4c66b976..89031c15ff 100644
--- a/apps/server/src/app.test.ts
+++ b/apps/server/src/app.test.ts
@@ -42,11 +42,13 @@ function createTestDeps() {
     characterService: {} as any,
     chatService: {} as any,
     providerService: {} as any,
+    nsfwMediaService: {} as any,
     fluxService: {} as any,
     fluxTransactionService: {} as any,
     stripeService: {} as any,
     billingService: {} as any,
     billingMq: {} as any,
+    nsfwImageMq: {} as any,
     configKV: {
       getOrThrow: vi.fn(async (key: string) => {
         switch (key) {
diff --git a/apps/server/src/app.ts b/apps/server/src/app.ts
index 7091901359..63b0b1b673 100644
--- a/apps/server/src/app.ts
+++ b/apps/server/src/app.ts
@@ -399,7 +399,6 @@ export async function createApp() {
     otel,
   })
   const { app, injectWebSocket } = await buildApp({
-    db: resolved.db,
     auth: resolved.auth,
     db: resolved.db,
     characterService: resolved.characterService,
diff --git a/apps/server/src/schemas/nsfw-media.ts b/apps/server/src/schemas/nsfw-media.ts
index 4ea53d3f2a..f739a3c5ce 100644
--- a/apps/server/src/schemas/nsfw-media.ts
+++ b/apps/server/src/schemas/nsfw-media.ts
@@ -1,6 +1,6 @@
 import type { InferInsertModel, InferSelectModel } from 'drizzle-orm'
 
-import { integer, jsonb, pgTable, text, timestamp } from 'drizzle-orm/pg-core'
+import { jsonb, pgTable, text, timestamp } from 'drizzle-orm/pg-core'
 
 import { nanoid } from '../utils/id'
 

From cda2e995e8933e39c00f7b795a47fab274890bd8 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Fri, 3 Apr 2026 07:25:35 +0200
Subject: [PATCH 25/30] fix: resolve more TypeScript issues in Hermes and Auth

---
 packages/stage-ui/src/libs/hermes-transport.ts | 4 ++--
 packages/stage-ui/src/stores/auth.ts           | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/stage-ui/src/libs/hermes-transport.ts b/packages/stage-ui/src/libs/hermes-transport.ts
index 76d870b9d4..f704ebfeac 100644
--- a/packages/stage-ui/src/libs/hermes-transport.ts
+++ b/packages/stage-ui/src/libs/hermes-transport.ts
@@ -61,7 +61,7 @@ export function createStubHermesReply(request: HermesReplyRequest): HermesReplyR
       score: null,
       flags: [],
     },
-    sceneType: request.route === 'nsfw' ? 'nsfw' : request.character.relationshipMode,
+    sceneType: (request.route === 'nsfw' ? 'nsfw' : (request.character.relationshipMode === 'companion' ? 'roleplay' : request.character.relationshipMode)) as any,
   }
 }
 
@@ -104,7 +104,7 @@ export async function generateHermesImagePromptViaTransport(
       prompt: request.prompt,
       negativePrompt: '',
       tags: [],
-      sceneType: request.route === 'nsfw' ? 'nsfw' : request.character.relationshipMode,
+      sceneType: (request.route === 'nsfw' ? 'nsfw' : (request.character.relationshipMode === 'companion' ? 'roleplay' : request.character.relationshipMode)) as any,
     }
   }
 
diff --git a/packages/stage-ui/src/stores/auth.ts b/packages/stage-ui/src/stores/auth.ts
index 3137bdbf3e..7efffbc6d1 100644
--- a/packages/stage-ui/src/stores/auth.ts
+++ b/packages/stage-ui/src/stores/auth.ts
@@ -224,7 +224,7 @@ export const useAuthStore = defineStore('auth', () => {
     user.value = {
       ...user.value,
       ...data,
-    } as User
+    } as unknown as User
     return user.value
   }
 
@@ -246,7 +246,7 @@ export const useAuthStore = defineStore('auth', () => {
     user.value = {
       ...user.value,
       ...data,
-    } as User
+    } as unknown as User
     return user.value
   }
 

From ae8e5e1c73e96b6730a74c97423f47060caf426e Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Sun, 5 Apr 2026 07:26:13 +0200
Subject: [PATCH 26/30] fix: lint fixes and sync with upstream

- Auto-fix lint issues
- Sync with moeru-ai/airi upstream

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 apps/server/src/routes/nsfw-media/index.ts    |   6 +-
 .../characters/components/CharacterItem.vue   |   2 +-
 packages/server-schema/src/index.ts           |   2 +-
 packages/stage-pages/src/pages/nsfw/[id].vue  |  28 +-
 .../stage-pages/src/pages/nsfw/generate.vue   |  30 +-
 packages/stage-pages/src/pages/nsfw/index.vue | 740 +++++++++---------
 packages/stage-pages/src/pages/v2/[id].vue    |  22 +-
 packages/stage-pages/src/pages/v2/index.vue   |  60 +-
 packages/stage-ui/src/libs/hermes.ts          |   3 +-
 packages/stage-ui/src/stores/characters.ts    |   1 +
 .../src/stores/chat/hermes-memory-store.ts    |   3 +-
 scripts/airi-web.sh                           | 140 ++++
 scripts/ci/pnpm-install.sh                    |  30 +
 13 files changed, 620 insertions(+), 447 deletions(-)
 create mode 100755 scripts/airi-web.sh
 create mode 100644 scripts/ci/pnpm-install.sh

diff --git a/apps/server/src/routes/nsfw-media/index.ts b/apps/server/src/routes/nsfw-media/index.ts
index 9681200428..e2c7c4aaf2 100644
--- a/apps/server/src/routes/nsfw-media/index.ts
+++ b/apps/server/src/routes/nsfw-media/index.ts
@@ -1,15 +1,15 @@
-import type { NsfwMediaService } from '../../services/nsfw-media'
 import type { MqService } from '../../libs/mq'
 import type { NsfwImageEvent } from '../../services/nsfw-image-events'
+import type { NsfwMediaService } from '../../services/nsfw-media'
 import type { HonoEnv } from '../../types/hono'
 
 import { Hono } from 'hono'
 import { safeParse } from 'valibot'
 
 import { authGuard } from '../../middlewares/auth'
-import { nanoid } from '../../utils/id'
-import { createBadRequestError } from '../../utils/error'
 import { createNsfwImageRequestedEvent } from '../../services/nsfw-image-events'
+import { createBadRequestError } from '../../utils/error'
+import { nanoid } from '../../utils/id'
 import { CreateGalleryItemSchema, CreateImageJobSchema } from './schema'
 
 export function createNsfwMediaRoutes(mediaService: NsfwMediaService, nsfwImageMq?: MqService<NsfwImageEvent>) {
diff --git a/apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue b/apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue
index b0cdb07f53..dfbdd3a375 100644
--- a/apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue
+++ b/apps/stage-web/src/pages/settings/characters/components/CharacterItem.vue
@@ -79,7 +79,7 @@ const voiceModel = computed(() => {
         <span
           v-for="badge in badges"
           :key="badge"
-          class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] text-neutral-600 font-medium uppercase tracking-wide dark:bg-neutral-800 dark:text-neutral-300"
+          class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] text-neutral-600 font-medium tracking-wide uppercase dark:bg-neutral-800 dark:text-neutral-300"
         >
           {{ badge }}
         </span>
diff --git a/packages/server-schema/src/index.ts b/packages/server-schema/src/index.ts
index 0f25e08680..2ad5bd60f0 100644
--- a/packages/server-schema/src/index.ts
+++ b/packages/server-schema/src/index.ts
@@ -1,2 +1,2 @@
-export { default as migrations } from 'virtual:drizzle-migrations.sql'
 export * from './hermes-contract'
+export { default as migrations } from 'virtual:drizzle-migrations.sql'
diff --git a/packages/stage-pages/src/pages/nsfw/[id].vue b/packages/stage-pages/src/pages/nsfw/[id].vue
index dd8de6a54d..52e7d86fa8 100644
--- a/packages/stage-pages/src/pages/nsfw/[id].vue
+++ b/packages/stage-pages/src/pages/nsfw/[id].vue
@@ -86,19 +86,19 @@ async function enterStage() {
       </div>
 
       <div v-else class="grid gap-6 lg:grid-cols-[1.15fr,0.85fr]">
-        <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-rose-950 to-black text-white shadow-sm">
+        <section class="bg-linear-to-br relative overflow-hidden rounded-[2rem] from-neutral-950 via-rose-950 to-black text-white shadow-sm">
           <img
             :src="character.coverUrl"
             :alt="i18n.name"
             class="absolute inset-0 h-full w-full object-cover opacity-40"
           >
-          <div class="absolute inset-0 bg-linear-to-t from-black via-black/50 to-transparent" />
-          <div class="relative z-1 flex min-h-[34rem] flex-col justify-end gap-5 p-6 md:p-8">
+          <div class="bg-linear-to-t absolute inset-0 from-black via-black/50 to-transparent" />
+          <div class="relative z-1 min-h-[34rem] flex flex-col justify-end gap-5 p-6 md:p-8">
             <div class="flex flex-wrap gap-2">
               <span
                 v-for="badge in accessBadges"
                 :key="badge"
-                class="rounded-full bg-white/12 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur"
+                class="rounded-full bg-white/12 px-3 py-1 text-[11px] font-medium tracking-[0.16em] uppercase backdrop-blur"
               >
                 {{ badge }}
               </span>
@@ -108,14 +108,14 @@ async function enterStage() {
               <h1 class="text-4xl font-semibold md:text-5xl">
                 {{ i18n.name }}
               </h1>
-              <p class="mt-3 max-w-xl text-sm leading-6 text-white/80 md:text-base">
+              <p class="mt-3 max-w-xl text-sm text-white/80 leading-6 md:text-base">
                 {{ character.personaProfile?.personality || i18n.description }}
               </p>
             </div>
 
             <div class="grid gap-3 sm:grid-cols-3">
               <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
-                <div class="text-[11px] uppercase tracking-[0.16em] text-white/60">
+                <div class="text-[11px] text-white/60 tracking-[0.16em] uppercase">
                   Surface
                 </div>
                 <div class="mt-1 text-sm font-medium">
@@ -123,7 +123,7 @@ async function enterStage() {
                 </div>
               </div>
               <div v-if="character.personaProfile?.speakingStyle" class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
-                <div class="text-[11px] uppercase tracking-[0.16em] text-white/60">
+                <div class="text-[11px] text-white/60 tracking-[0.16em] uppercase">
                   Speaking Style
                 </div>
                 <div class="mt-1 text-sm font-medium">
@@ -131,7 +131,7 @@ async function enterStage() {
                 </div>
               </div>
               <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
-                <div class="text-[11px] uppercase tracking-[0.16em] text-white/60">
+                <div class="text-[11px] text-white/60 tracking-[0.16em] uppercase">
                   Dynamic
                 </div>
                 <div class="mt-1 text-sm font-medium">
@@ -162,7 +162,7 @@ async function enterStage() {
             <h2 class="text-lg font-semibold">
               Scenario
             </h2>
-            <p class="mt-3 text-sm leading-6 text-neutral-600 dark:text-neutral-300">
+            <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
               {{ character.personaProfile?.scenario || i18n.description }}
             </p>
           </div>
@@ -193,7 +193,7 @@ async function enterStage() {
               <span
                 v-for="boundary in boundaries"
                 :key="boundary"
-                class="rounded-full bg-amber-100 px-3 py-1 text-xs font-medium text-amber-700 dark:bg-amber-500/15 dark:text-amber-300"
+                class="rounded-full bg-amber-100 px-3 py-1 text-xs text-amber-700 font-medium dark:bg-amber-500/15 dark:text-amber-300"
               >
                 {{ boundary }}
               </span>
@@ -207,12 +207,12 @@ async function enterStage() {
             <h2 class="text-lg font-semibold">
               Engagement
             </h2>
-            <div class="mt-4 grid grid-cols-3 gap-3">
+            <div class="grid grid-cols-3 mt-4 gap-3">
               <div class="rounded-2xl bg-neutral-50 px-4 py-3 text-center dark:bg-neutral-800">
                 <div class="text-xl font-semibold">
                   {{ character.likesCount }}
                 </div>
-                <div class="text-xs uppercase tracking-wide text-neutral-500 dark:text-neutral-400">
+                <div class="text-xs text-neutral-500 tracking-wide uppercase dark:text-neutral-400">
                   Likes
                 </div>
               </div>
@@ -220,7 +220,7 @@ async function enterStage() {
                 <div class="text-xl font-semibold">
                   {{ character.bookmarksCount }}
                 </div>
-                <div class="text-xs uppercase tracking-wide text-neutral-500 dark:text-neutral-400">
+                <div class="text-xs text-neutral-500 tracking-wide uppercase dark:text-neutral-400">
                   Saves
                 </div>
               </div>
@@ -228,7 +228,7 @@ async function enterStage() {
                 <div class="text-xl font-semibold">
                   {{ character.interactionsCount }}
                 </div>
-                <div class="text-xs uppercase tracking-wide text-neutral-500 dark:text-neutral-400">
+                <div class="text-xs text-neutral-500 tracking-wide uppercase dark:text-neutral-400">
                   Chats
                 </div>
               </div>
diff --git a/packages/stage-pages/src/pages/nsfw/generate.vue b/packages/stage-pages/src/pages/nsfw/generate.vue
index 6f6dc055a4..2b45068edf 100644
--- a/packages/stage-pages/src/pages/nsfw/generate.vue
+++ b/packages/stage-pages/src/pages/nsfw/generate.vue
@@ -161,11 +161,11 @@ async function saveToGallery() {
 <template>
   <div class="min-h-screen px-4 py-8 md:px-8">
     <div mx-auto max-w-6xl class="space-y-6">
-      <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-fuchsia-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
+      <section class="bg-linear-to-br relative overflow-hidden rounded-[2rem] from-neutral-950 via-fuchsia-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
         <div class="absolute right--12 top--14 h-60 w-60 rounded-full bg-fuchsia-400/15 blur-3xl" />
         <div class="absolute bottom--12 left-8 h-48 w-48 rounded-full bg-rose-300/10 blur-3xl" />
         <div class="relative z-1 max-w-3xl">
-          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.16em] backdrop-blur">
+          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium tracking-[0.16em] uppercase backdrop-blur">
             NSFW Generate
           </div>
           <h1 class="text-4xl font-semibold leading-tight md:text-5xl">
@@ -207,7 +207,7 @@ async function saveToGallery() {
             <div class="mt-4 space-y-4">
               <div class="flex flex-col gap-1.5">
                 <label class="text-sm font-medium">Character</label>
-                <select v-model="selectedCharacterId" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                <select v-model="selectedCharacterId" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
                   <option value="" disabled>
                     Select a character
                   </option>
@@ -222,7 +222,7 @@ async function saveToGallery() {
                 <textarea
                   v-model="form.prompt"
                   rows="6"
-                  class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800"
+                  class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800"
                   placeholder="Describe the shot you want, the pose, outfit, setting, or scene beat."
                 />
               </div>
@@ -230,24 +230,24 @@ async function saveToGallery() {
               <div class="grid gap-4 sm:grid-cols-2">
                 <div class="flex flex-col gap-1.5">
                   <label class="text-sm font-medium">Style</label>
-                  <input v-model="form.style" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                  <input v-model="form.style" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
                 </div>
 
                 <div class="flex flex-col gap-1.5">
                   <label class="text-sm font-medium">Mood</label>
-                  <input v-model="form.mood" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                  <input v-model="form.mood" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
                 </div>
               </div>
 
               <div class="grid gap-4 sm:grid-cols-2">
                 <div class="flex flex-col gap-1.5">
                   <label class="text-sm font-medium">Framing</label>
-                  <input v-model="form.framing" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                  <input v-model="form.framing" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
                 </div>
 
                 <div class="flex flex-col gap-1.5">
                   <label class="text-sm font-medium">Aspect Ratio</label>
-                  <input v-model="form.aspectRatio" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                  <input v-model="form.aspectRatio" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
                 </div>
               </div>
 
@@ -256,7 +256,7 @@ async function saveToGallery() {
                 <textarea
                   v-model="form.comfyWorkflow"
                   rows="7"
-                  class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 font-mono text-xs outline-none dark:border-neutral-700 dark:bg-neutral-800"
+                  class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-xs font-mono outline-none dark:border-neutral-700 dark:bg-neutral-800"
                 />
                 <p class="text-xs text-neutral-500 leading-5 dark:text-neutral-400">
                   Optional override. If left empty, AIRI now builds a default API-format ComfyUI workflow from the planned prompt, negative prompt, aspect ratio, and server checkpoint setting.
@@ -288,7 +288,7 @@ async function saveToGallery() {
 
             <div v-if="result" class="mt-4 space-y-5">
               <div>
-                <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                <div class="text-[11px] text-neutral-500 font-medium tracking-[0.16em] uppercase dark:text-neutral-400">
                   Scene Type
                 </div>
                 <div class="mt-1 text-sm font-medium">
@@ -297,7 +297,7 @@ async function saveToGallery() {
               </div>
 
               <div>
-                <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                <div class="text-[11px] text-neutral-500 font-medium tracking-[0.16em] uppercase dark:text-neutral-400">
                   Prompt
                 </div>
                 <div class="mt-2 rounded-2xl bg-neutral-50 px-4 py-4 text-sm leading-6 dark:bg-neutral-800">
@@ -306,7 +306,7 @@ async function saveToGallery() {
               </div>
 
               <div>
-                <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                <div class="text-[11px] text-neutral-500 font-medium tracking-[0.16em] uppercase dark:text-neutral-400">
                   Negative Prompt
                 </div>
                 <div class="mt-2 rounded-2xl bg-neutral-50 px-4 py-4 text-sm leading-6 dark:bg-neutral-800">
@@ -315,14 +315,14 @@ async function saveToGallery() {
               </div>
 
               <div>
-                <div class="text-[11px] font-medium uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
+                <div class="text-[11px] text-neutral-500 font-medium tracking-[0.16em] uppercase dark:text-neutral-400">
                   Tags
                 </div>
                 <div class="mt-3 flex flex-wrap gap-2">
                   <span
                     v-for="tag in result.tags"
                     :key="tag"
-                    class="rounded-full bg-fuchsia-100 px-3 py-1 text-xs font-medium text-fuchsia-700 dark:bg-fuchsia-500/15 dark:text-fuchsia-300"
+                    class="rounded-full bg-fuchsia-100 px-3 py-1 text-xs text-fuchsia-700 font-medium dark:bg-fuchsia-500/15 dark:text-fuchsia-300"
                   >
                     {{ tag }}
                   </span>
@@ -339,7 +339,7 @@ async function saveToGallery() {
               </div>
             </div>
 
-            <div v-else class="mt-4 rounded-2xl border border-dashed border-neutral-200 px-5 py-10 text-sm text-neutral-500 dark:border-neutral-700 dark:text-neutral-400">
+            <div v-else class="mt-4 border border-neutral-200 rounded-2xl border-dashed px-5 py-10 text-sm text-neutral-500 dark:border-neutral-700 dark:text-neutral-400">
               Generate a prompt to see the final scene package Hermes would send toward your image pipeline.
             </div>
           </div>
diff --git a/packages/stage-pages/src/pages/nsfw/index.vue b/packages/stage-pages/src/pages/nsfw/index.vue
index 5c7edc219d..23e235de72 100644
--- a/packages/stage-pages/src/pages/nsfw/index.vue
+++ b/packages/stage-pages/src/pages/nsfw/index.vue
@@ -147,7 +147,7 @@ async function saveSelectedCharacter() {
       relationshipMode: editor.relationshipMode,
       visibility: editor.visibility,
       personaProfile: {
-        ...(selectedCharacter.value.personaProfile ?? {}),
+        ...selectedCharacter.value.personaProfile,
         boundaries: editor.boundaries
           .split('\n')
           .map(item => item.trim())
@@ -168,11 +168,11 @@ async function saveSelectedCharacter() {
 <template>
   <div class="min-h-screen px-4 py-8 md:px-8">
     <div mx-auto max-w-7xl class="space-y-8">
-      <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-rose-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
+      <section class="bg-linear-to-br relative overflow-hidden rounded-[2rem] from-neutral-950 via-rose-950 to-black px-6 py-8 text-white shadow-sm md:px-10 md:py-12">
         <div class="absolute right--12 top--14 h-60 w-60 rounded-full bg-rose-400/15 blur-3xl" />
         <div class="absolute bottom--12 left-8 h-48 w-48 rounded-full bg-orange-300/10 blur-3xl" />
         <div class="relative z-1 max-w-3xl">
-          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.16em] backdrop-blur">
+          <div class="mb-3 inline-flex items-center gap-2 rounded-full bg-white/10 px-3 py-1 text-xs font-medium tracking-[0.16em] uppercase backdrop-blur">
             NSFW Explore
           </div>
           <h1 class="max-w-2xl text-4xl font-semibold leading-tight md:text-5xl">
@@ -215,432 +215,432 @@ async function saveSelectedCharacter() {
       </section>
 
       <template v-else>
-      <section class="grid gap-4 lg:grid-cols-[1.3fr,0.7fr]">
-        <div class="rounded-[1.75rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
-          <div class="flex items-center justify-between gap-4">
-            <div>
-              <h2 class="text-lg font-semibold">
-                NSFW Inventory
-              </h2>
-              <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
-                Only characters with `nsfwEnabled` and a non-`none` level show up here.
-              </p>
-            </div>
-            <Button variant="ghost" @click="router.push('/settings/characters')">
-              Manage Characters
-            </Button>
-          </div>
-          <div class="mt-5 grid gap-3 sm:grid-cols-4">
-            <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
-              <div class="text-[11px] uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
-                Total
-              </div>
-              <div class="mt-1 text-2xl font-semibold">
-                {{ stats.total }}
-              </div>
-            </div>
-            <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
-              <div class="text-[11px] uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
-                Explicit
-              </div>
-              <div class="mt-1 text-2xl font-semibold">
-                {{ stats.explicit }}
+        <section class="grid gap-4 lg:grid-cols-[1.3fr,0.7fr]">
+          <div class="rounded-[1.75rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <div class="flex items-center justify-between gap-4">
+              <div>
+                <h2 class="text-lg font-semibold">
+                  NSFW Inventory
+                </h2>
+                <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+                  Only characters with `nsfwEnabled` and a non-`none` level show up here.
+                </p>
               </div>
+              <Button variant="ghost" @click="router.push('/settings/characters')">
+                Manage Characters
+              </Button>
             </div>
-            <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
-              <div class="text-[11px] uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
-                Suggestive
+            <div class="grid mt-5 gap-3 sm:grid-cols-4">
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+                <div class="text-[11px] text-neutral-500 tracking-[0.16em] uppercase dark:text-neutral-400">
+                  Total
+                </div>
+                <div class="mt-1 text-2xl font-semibold">
+                  {{ stats.total }}
+                </div>
               </div>
-              <div class="mt-1 text-2xl font-semibold">
-                {{ stats.suggestive }}
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+                <div class="text-[11px] text-neutral-500 tracking-[0.16em] uppercase dark:text-neutral-400">
+                  Explicit
+                </div>
+                <div class="mt-1 text-2xl font-semibold">
+                  {{ stats.explicit }}
+                </div>
               </div>
-            </div>
-            <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
-              <div class="text-[11px] uppercase tracking-[0.16em] text-neutral-500 dark:text-neutral-400">
-                Active
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+                <div class="text-[11px] text-neutral-500 tracking-[0.16em] uppercase dark:text-neutral-400">
+                  Suggestive
+                </div>
+                <div class="mt-1 text-2xl font-semibold">
+                  {{ stats.suggestive }}
+                </div>
               </div>
-              <div class="mt-1 text-2xl font-semibold">
-                {{ stats.active }}
+              <div class="rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+                <div class="text-[11px] text-neutral-500 tracking-[0.16em] uppercase dark:text-neutral-400">
+                  Active
+                </div>
+                <div class="mt-1 text-2xl font-semibold">
+                  {{ stats.active }}
+                </div>
               </div>
             </div>
           </div>
-        </div>
-
-        <div class="rounded-[1.75rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
-          <h2 class="text-lg font-semibold">
-            Route Split
-          </h2>
-          <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
-            Normal `v2` discovery stays clean. Adult discovery, explicit persona tags, and future gallery generation stay under `/nsfw`.
-          </p>
-          <div class="mt-5 flex flex-wrap gap-3">
-            <Button @click="router.push('/v2')">
-              Open Normal Explore
-            </Button>
-            <Button variant="ghost" @click="router.push('/nsfw/generate')">
-              Open Generate
-            </Button>
-            <Button variant="ghost" @click="router.push('/nsfw/gallery')">
-              Open Gallery
-            </Button>
-            <Button variant="ghost" @click="router.push('/settings/characters')">
-              Edit Character Flags
-            </Button>
-          </div>
-        </div>
-      </section>
 
-      <section class="grid gap-4 lg:grid-cols-[0.9fr,1.1fr]">
-        <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
-          <div class="flex items-center justify-between gap-3">
+          <div class="rounded-[1.75rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
             <h2 class="text-lg font-semibold">
-              Character Controls
+              Route Split
             </h2>
-            <span v-if="selectedCharacter" class="text-xs text-neutral-500 dark:text-neutral-400">
-              {{ selectedCharacter.i18n?.[0]?.name || selectedCharacter.characterId }}
-            </span>
+            <p class="mt-2 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+              Normal `v2` discovery stays clean. Adult discovery, explicit persona tags, and future gallery generation stay under `/nsfw`.
+            </p>
+            <div class="mt-5 flex flex-wrap gap-3">
+              <Button @click="router.push('/v2')">
+                Open Normal Explore
+              </Button>
+              <Button variant="ghost" @click="router.push('/nsfw/generate')">
+                Open Generate
+              </Button>
+              <Button variant="ghost" @click="router.push('/nsfw/gallery')">
+                Open Gallery
+              </Button>
+              <Button variant="ghost" @click="router.push('/settings/characters')">
+                Edit Character Flags
+              </Button>
+            </div>
           </div>
+        </section>
 
-          <div class="mt-4 space-y-3">
-            <button
-              v-for="character in characters"
-              :key="character.id"
-              type="button"
-              class="flex w-full items-center justify-between rounded-2xl px-4 py-3 text-left transition"
-              :class="selectedCharacterId === character.id
-                ? 'bg-neutral-950 text-white dark:bg-white dark:text-neutral-950'
-                : 'bg-neutral-50 hover:bg-neutral-100 dark:bg-neutral-800 dark:hover:bg-neutral-700'"
-              @click="selectedCharacterId = character.id"
-            >
-              <div class="min-w-0">
-                <div class="line-clamp-1 text-sm font-medium">
-                  {{ character.name }}
+        <section class="grid gap-4 lg:grid-cols-[0.9fr,1.1fr]">
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <div class="flex items-center justify-between gap-3">
+              <h2 class="text-lg font-semibold">
+                Character Controls
+              </h2>
+              <span v-if="selectedCharacter" class="text-xs text-neutral-500 dark:text-neutral-400">
+                {{ selectedCharacter.i18n?.[0]?.name || selectedCharacter.characterId }}
+              </span>
+            </div>
+
+            <div class="mt-4 space-y-3">
+              <button
+                v-for="character in characters"
+                :key="character.id"
+                type="button"
+                class="w-full flex items-center justify-between rounded-2xl px-4 py-3 text-left transition"
+                :class="selectedCharacterId === character.id
+                  ? 'bg-neutral-950 text-white dark:bg-white dark:text-neutral-950'
+                  : 'bg-neutral-50 hover:bg-neutral-100 dark:bg-neutral-800 dark:hover:bg-neutral-700'"
+                @click="selectedCharacterId = character.id"
+              >
+                <div class="min-w-0">
+                  <div class="line-clamp-1 text-sm font-medium">
+                    {{ character.name }}
+                  </div>
+                  <div class="line-clamp-1 mt-1 text-xs opacity-75">
+                    {{ character.nsfwLevel }} · {{ character.relationshipMode }}
+                  </div>
                 </div>
-                <div class="mt-1 line-clamp-1 text-xs opacity-75">
-                  {{ character.nsfwLevel }} · {{ character.relationshipMode }}
+                <div class="ml-4 shrink-0 text-xs opacity-75">
+                  {{ character.visibility }}
                 </div>
-              </div>
-              <div class="ml-4 shrink-0 text-xs opacity-75">
-                {{ character.visibility }}
-              </div>
-            </button>
+              </button>
+            </div>
           </div>
-        </div>
 
-        <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
-          <h2 class="text-lg font-semibold">
-            NSFW Settings
-          </h2>
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              NSFW Settings
+            </h2>
 
-          <div v-if="selectedCharacter" class="mt-4 space-y-4">
-            <label class="flex items-center justify-between gap-4 rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
-              <div>
-                <div class="text-sm font-medium">
-                  NSFW Enabled
+            <div v-if="selectedCharacter" class="mt-4 space-y-4">
+              <label class="flex items-center justify-between gap-4 rounded-2xl bg-neutral-50 px-4 py-3 dark:bg-neutral-800">
+                <div>
+                  <div class="text-sm font-medium">
+                    NSFW Enabled
+                  </div>
+                  <div class="mt-1 text-xs text-neutral-500 dark:text-neutral-400">
+                    Controls whether this character can appear in `/nsfw`.
+                  </div>
                 </div>
-                <div class="mt-1 text-xs text-neutral-500 dark:text-neutral-400">
-                  Controls whether this character can appear in `/nsfw`.
+                <input v-model="editor.nsfwEnabled" type="checkbox" class="h-4 w-4">
+              </label>
+
+              <div class="grid gap-4 sm:grid-cols-2">
+                <div class="flex flex-col gap-1.5">
+                  <label class="text-sm font-medium">NSFW Level</label>
+                  <select v-model="editor.nsfwLevel" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                    <option value="none">
+                      None
+                    </option>
+                    <option value="suggestive">
+                      Suggestive
+                    </option>
+                    <option value="explicit">
+                      Explicit
+                    </option>
+                  </select>
+                </div>
+
+                <div class="flex flex-col gap-1.5">
+                  <label class="text-sm font-medium">Relationship Mode</label>
+                  <select v-model="editor.relationshipMode" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                    <option value="companion">
+                      Companion
+                    </option>
+                    <option value="romance">
+                      Romance
+                    </option>
+                    <option value="roleplay">
+                      Roleplay
+                    </option>
+                  </select>
                 </div>
               </div>
-              <input v-model="editor.nsfwEnabled" type="checkbox" class="h-4 w-4">
-            </label>
 
-            <div class="grid gap-4 sm:grid-cols-2">
               <div class="flex flex-col gap-1.5">
-                <label class="text-sm font-medium">NSFW Level</label>
-                <select v-model="editor.nsfwLevel" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
-                  <option value="none">
-                    None
+                <label class="text-sm font-medium">Visibility</label>
+                <select v-model="editor.visibility" class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
+                  <option value="private">
+                    Private
                   </option>
-                  <option value="suggestive">
-                    Suggestive
+                  <option value="unlisted">
+                    Unlisted
                   </option>
-                  <option value="explicit">
-                    Explicit
+                  <option value="public">
+                    Public
                   </option>
                 </select>
               </div>
 
               <div class="flex flex-col gap-1.5">
-                <label class="text-sm font-medium">Relationship Mode</label>
-                <select v-model="editor.relationshipMode" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
-                  <option value="companion">
-                    Companion
-                  </option>
-                  <option value="romance">
-                    Romance
-                  </option>
-                  <option value="roleplay">
-                    Roleplay
-                  </option>
-                </select>
+                <label class="text-sm font-medium">Boundaries</label>
+                <textarea
+                  v-model="editor.boundaries"
+                  rows="5"
+                  class="w-full border border-neutral-200 rounded-lg bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800"
+                  placeholder="One per line"
+                />
               </div>
-            </div>
 
-            <div class="flex flex-col gap-1.5">
-              <label class="text-sm font-medium">Visibility</label>
-              <select v-model="editor.visibility" class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800">
-                <option value="private">
-                  Private
-                </option>
-                <option value="unlisted">
-                  Unlisted
-                </option>
-                <option value="public">
-                  Public
-                </option>
-              </select>
-            </div>
-
-            <div class="flex flex-col gap-1.5">
-              <label class="text-sm font-medium">Boundaries</label>
-              <textarea
-                v-model="editor.boundaries"
-                rows="5"
-                class="w-full rounded-lg border border-neutral-200 bg-white px-3 py-2 text-sm outline-none dark:border-neutral-700 dark:bg-neutral-800"
-                placeholder="One per line"
-              />
-            </div>
-
-            <div class="flex items-center gap-3">
-              <Button :disabled="savingCharacter" @click="saveSelectedCharacter">
-                {{ savingCharacter ? 'Saving...' : 'Save NSFW Settings' }}
-              </Button>
-              <span v-if="saveSuccess" class="text-sm text-emerald-600 dark:text-emerald-400">
-                Saved
-              </span>
-              <span v-if="saveError" class="text-sm text-rose-600 dark:text-rose-400">
-                {{ saveError }}
-              </span>
+              <div class="flex items-center gap-3">
+                <Button :disabled="savingCharacter" @click="saveSelectedCharacter">
+                  {{ savingCharacter ? 'Saving...' : 'Save NSFW Settings' }}
+                </Button>
+                <span v-if="saveSuccess" class="text-sm text-emerald-600 dark:text-emerald-400">
+                  Saved
+                </span>
+                <span v-if="saveError" class="text-sm text-rose-600 dark:text-rose-400">
+                  {{ saveError }}
+                </span>
+              </div>
             </div>
-          </div>
-
-          <div v-else class="mt-4 text-sm text-neutral-500 dark:text-neutral-400">
-            Select a character to edit its NSFW settings.
-          </div>
-        </div>
-      </section>
 
-      <section v-if="featuredCharacter" class="grid gap-4 lg:grid-cols-[1.1fr,0.9fr]">
-        <div class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-neutral-900 to-rose-950 p-6 text-white shadow-sm">
-          <img
-            v-if="featuredCharacter.coverUrl"
-            :src="featuredCharacter.coverUrl"
-            :alt="featuredCharacter.name"
-            class="absolute inset-0 h-full w-full object-cover opacity-25"
-          >
-          <div class="absolute inset-0 bg-linear-to-r from-black via-black/60 to-transparent" />
-          <div class="relative z-1 max-w-xl">
-            <div class="inline-flex rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur">
-              Top By Chats
-            </div>
-            <h2 class="mt-4 text-3xl font-semibold">
-              {{ featuredCharacter.name }}
-            </h2>
-            <p class="mt-3 text-sm leading-6 text-white/75">
-              {{ featuredCharacter.personality || featuredCharacter.scenario || featuredCharacter.tagline }}
-            </p>
-            <div class="mt-4 flex flex-wrap gap-2">
-              <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur">
-                {{ featuredCharacter.nsfwLevel }}
-              </span>
-              <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur">
-                {{ featuredCharacter.relationshipMode }}
-              </span>
-              <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur">
-                {{ formatCount(featuredCharacter.interactions) }} chats
-              </span>
-            </div>
-            <div class="mt-6 flex flex-wrap gap-3">
-              <Button @click="openCharacter(featuredCharacter.id)">
-                Open Profile
-              </Button>
-              <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/nsfw/generate')">
-                Generate Prompt
-              </Button>
-              <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="characterStore.activateCharacter(featuredCharacter.id)">
-                Activate Only
-              </Button>
+            <div v-else class="mt-4 text-sm text-neutral-500 dark:text-neutral-400">
+              Select a character to edit its NSFW settings.
             </div>
           </div>
-        </div>
+        </section>
 
-        <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
-          <h2 class="text-lg font-semibold">
-            Recent NSFW Picks
-          </h2>
-          <div class="mt-4 space-y-3">
-            <button
-              v-for="character in latestCharacters"
-              :key="character.id"
-              type="button"
-              class="flex w-full items-center justify-between rounded-2xl bg-neutral-50 px-4 py-3 text-left transition hover:bg-neutral-100 dark:bg-neutral-800 dark:hover:bg-neutral-700"
-              @click="openCharacter(character.id)"
+        <section v-if="featuredCharacter" class="grid gap-4 lg:grid-cols-[1.1fr,0.9fr]">
+          <div class="bg-linear-to-br relative overflow-hidden rounded-[2rem] from-neutral-950 via-neutral-900 to-rose-950 p-6 text-white shadow-sm">
+            <img
+              v-if="featuredCharacter.coverUrl"
+              :src="featuredCharacter.coverUrl"
+              :alt="featuredCharacter.name"
+              class="absolute inset-0 h-full w-full object-cover opacity-25"
             >
-              <div class="min-w-0">
-                <div class="line-clamp-1 text-sm font-medium">
-                  {{ character.name }}
-                </div>
-                <div class="mt-1 line-clamp-1 text-xs text-neutral-500 dark:text-neutral-400">
-                  {{ character.personality || character.tagline }}
-                </div>
+            <div class="bg-linear-to-r absolute inset-0 from-black via-black/60 to-transparent" />
+            <div class="relative z-1 max-w-xl">
+              <div class="inline-flex rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium tracking-[0.16em] uppercase backdrop-blur">
+                Top By Chats
               </div>
-              <div class="ml-4 flex shrink-0 items-center gap-2">
-                <span class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide text-rose-700 dark:bg-rose-500/15 dark:text-rose-300">
-                  {{ character.nsfwLevel }}
+              <h2 class="mt-4 text-3xl font-semibold">
+                {{ featuredCharacter.name }}
+              </h2>
+              <p class="mt-3 text-sm text-white/75 leading-6">
+                {{ featuredCharacter.personality || featuredCharacter.scenario || featuredCharacter.tagline }}
+              </p>
+              <div class="mt-4 flex flex-wrap gap-2">
+                <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium tracking-[0.16em] uppercase backdrop-blur">
+                  {{ featuredCharacter.nsfwLevel }}
+                </span>
+                <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium tracking-[0.16em] uppercase backdrop-blur">
+                  {{ featuredCharacter.relationshipMode }}
+                </span>
+                <span class="rounded-full bg-white/10 px-3 py-1 text-[11px] font-medium tracking-[0.16em] uppercase backdrop-blur">
+                  {{ formatCount(featuredCharacter.interactions) }} chats
                 </span>
-                <div class="i-solar:arrow-right-linear text-base text-neutral-400" />
               </div>
-            </button>
-          </div>
-        </div>
-      </section>
-
-      <section
-        v-if="!characters.length"
-        class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800"
-      >
-        <h2 class="text-2xl font-semibold">
-          No NSFW characters available
-        </h2>
-        <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
-          Turn on NSFW for a character and assign a level before it appears here.
-        </p>
-        <div class="mt-6 flex justify-center gap-3">
-          <Button @click="router.push('/settings/characters')">
-            Open Character Settings
-          </Button>
-          <Button variant="ghost" @click="router.push('/v2')">
-            Back to Normal Explore
-          </Button>
-        </div>
-      </section>
-
-      <section v-else class="grid gap-6 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5">
-        <article
-          v-for="character in characters"
-          :key="character.id"
-          class="group relative aspect-[12/19] overflow-hidden rounded-3xl shadow-sm"
-        >
-          <div class="relative h-70% overflow-hidden rounded-2xl">
-            <img
-              v-if="character.coverBackgroundUrl"
-              :src="character.coverBackgroundUrl"
-              :alt="character.name"
-              class="absolute inset-0 z-5 h-full w-full object-cover"
-            >
-            <div v-else class="absolute inset-0 z-5 h-full w-full bg-neutral-950" />
-            <img
-              v-if="character.coverUrl"
-              :src="character.coverUrl"
-              :alt="character.name"
-              class="absolute left-0 top-0 z-5 h-full w-full object-cover transition duration-300 ease-in-out"
-            >
+              <div class="mt-6 flex flex-wrap gap-3">
+                <Button @click="openCharacter(featuredCharacter.id)">
+                  Open Profile
+                </Button>
+                <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="router.push('/nsfw/generate')">
+                  Generate Prompt
+                </Button>
+                <Button variant="ghost" class="bg-white/10 text-white hover:bg-white/15" @click="characterStore.activateCharacter(featuredCharacter.id)">
+                  Activate Only
+                </Button>
+              </div>
+            </div>
           </div>
 
-          <div class="relative z-7 h-30% overflow-hidden">
-            <div class="relative z-1 h-full">
-              <div class="relative flex h-full flex-col justify-between gap-2 px-3 pb-3 pt-2">
-                <div class="flex items-center justify-between gap-3">
-                  <div class="flex items-center gap-2">
-                    <img
-                      v-if="character.characterAvatarUrl"
-                      :src="character.characterAvatarUrl"
-                      :alt="character.name"
-                      class="h-7 w-7 rounded-full object-cover"
-                    >
-                    <div v-else class="h-7 w-7 rounded-full bg-neutral-300 dark:bg-neutral-700" />
-                    <div class="line-clamp-1 text-lg font-semibold">
-                      {{ character.name }}
-                    </div>
+          <div class="rounded-[2rem] bg-white p-6 shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800">
+            <h2 class="text-lg font-semibold">
+              Recent NSFW Picks
+            </h2>
+            <div class="mt-4 space-y-3">
+              <button
+                v-for="character in latestCharacters"
+                :key="character.id"
+                type="button"
+                class="w-full flex items-center justify-between rounded-2xl bg-neutral-50 px-4 py-3 text-left transition dark:bg-neutral-800 hover:bg-neutral-100 dark:hover:bg-neutral-700"
+                @click="openCharacter(character.id)"
+              >
+                <div class="min-w-0">
+                  <div class="line-clamp-1 text-sm font-medium">
+                    {{ character.name }}
                   </div>
-                  <div class="flex items-center gap-1 text-xs">
-                    <div i-tabler:coins />
-                    <div>{{ formatCount(character.priceCredit) }}</div>
+                  <div class="line-clamp-1 mt-1 text-xs text-neutral-500 dark:text-neutral-400">
+                    {{ character.personality || character.tagline }}
                   </div>
                 </div>
-
-                <div class="flex flex-wrap gap-1.5">
-                  <span class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide text-rose-700 dark:bg-rose-500/15 dark:text-rose-300">
+                <div class="ml-4 flex shrink-0 items-center gap-2">
+                  <span class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] text-rose-700 font-medium tracking-wide uppercase dark:bg-rose-500/15 dark:text-rose-300">
                     {{ character.nsfwLevel }}
                   </span>
-                  <span class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide text-neutral-600 dark:bg-neutral-800 dark:text-neutral-300">
-                    {{ character.relationshipMode }}
-                  </span>
-                  <span class="rounded-full bg-amber-100 px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide text-amber-700 dark:bg-amber-500/15 dark:text-amber-300">
-                    {{ character.visibility }}
-                  </span>
+                  <div class="i-solar:arrow-right-linear text-base text-neutral-400" />
                 </div>
+              </button>
+            </div>
+          </div>
+        </section>
 
-                <div class="max-h-[3rem] flex-1 overflow-hidden text-xs text-neutral-500 line-clamp-3">
-                  {{ character.personality || character.scenario || character.tagline }}
-                </div>
+        <section
+          v-if="!characters.length"
+          class="rounded-[2rem] bg-white p-10 text-center shadow-sm ring-1 ring-neutral-200 dark:bg-neutral-900 dark:ring-neutral-800"
+        >
+          <h2 class="text-2xl font-semibold">
+            No NSFW characters available
+          </h2>
+          <p class="mt-3 text-sm text-neutral-600 leading-6 dark:text-neutral-300">
+            Turn on NSFW for a character and assign a level before it appears here.
+          </p>
+          <div class="mt-6 flex justify-center gap-3">
+            <Button @click="router.push('/settings/characters')">
+              Open Character Settings
+            </Button>
+            <Button variant="ghost" @click="router.push('/v2')">
+              Back to Normal Explore
+            </Button>
+          </div>
+        </section>
 
-                <div class="grid grid-cols-3 items-center">
-                  <div class="flex items-center justify-start">
-                    <Button variant="ghost" size="sm" aria-label="Bookmark" @click="characterStore.bookmark(character.id)">
-                      <div
-                        :class="[
-                          character.bookmarked ? 'i-solar-star-bold' : 'i-solar-star-linear',
-                          'inline-block text-base',
-                          character.bookmarked ? 'text-amber-300 dark:text-amber-500' : 'text-neutral-400',
-                        ]"
-                      />
-                      <span
-                        :class="[
-                          'text-xs',
-                          character.bookmarked ? 'text-amber-500 dark:text-amber-300' : 'text-neutral-500',
-                        ]"
+        <section v-else class="grid gap-6 lg:grid-cols-4 md:grid-cols-3 sm:grid-cols-2 xl:grid-cols-5">
+          <article
+            v-for="character in characters"
+            :key="character.id"
+            class="group relative aspect-[12/19] overflow-hidden rounded-3xl shadow-sm"
+          >
+            <div class="relative h-70% overflow-hidden rounded-2xl">
+              <img
+                v-if="character.coverBackgroundUrl"
+                :src="character.coverBackgroundUrl"
+                :alt="character.name"
+                class="absolute inset-0 z-5 h-full w-full object-cover"
+              >
+              <div v-else class="absolute inset-0 z-5 h-full w-full bg-neutral-950" />
+              <img
+                v-if="character.coverUrl"
+                :src="character.coverUrl"
+                :alt="character.name"
+                class="absolute left-0 top-0 z-5 h-full w-full object-cover transition duration-300 ease-in-out"
+              >
+            </div>
+
+            <div class="relative z-7 h-30% overflow-hidden">
+              <div class="relative z-1 h-full">
+                <div class="relative h-full flex flex-col justify-between gap-2 px-3 pb-3 pt-2">
+                  <div class="flex items-center justify-between gap-3">
+                    <div class="flex items-center gap-2">
+                      <img
+                        v-if="character.characterAvatarUrl"
+                        :src="character.characterAvatarUrl"
+                        :alt="character.name"
+                        class="h-7 w-7 rounded-full object-cover"
                       >
-                        {{ formatCount(character.bookmarks) }}
-                      </span>
-                    </Button>
+                      <div v-else class="h-7 w-7 rounded-full bg-neutral-300 dark:bg-neutral-700" />
+                      <div class="line-clamp-1 text-lg font-semibold">
+                        {{ character.name }}
+                      </div>
+                    </div>
+                    <div class="flex items-center gap-1 text-xs">
+                      <div i-tabler:coins />
+                      <div>{{ formatCount(character.priceCredit) }}</div>
+                    </div>
                   </div>
-                  <div class="flex items-center justify-center">
-                    <Button variant="ghost" size="sm" aria-label="Like" @click="characterStore.like(character.id)">
-                      <div
-                        :class="[
-                          character.liked ? 'i-solar-heart-bold' : 'i-solar-heart-outline',
-                          'inline-block text-base',
-                          character.liked ? 'text-rose-500 dark:text-rose-400' : 'text-neutral-400',
-                        ]"
-                      />
-                      <span
-                        :class="[
-                          'text-xs',
-                          character.liked ? 'text-rose-500 dark:text-rose-400' : 'text-neutral-500',
-                        ]"
-                      >
-                        {{ formatCount(character.likes) }}
-                      </span>
-                    </Button>
+
+                  <div class="flex flex-wrap gap-1.5">
+                    <span class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] text-rose-700 font-medium tracking-wide uppercase dark:bg-rose-500/15 dark:text-rose-300">
+                      {{ character.nsfwLevel }}
+                    </span>
+                    <span class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] text-neutral-600 font-medium tracking-wide uppercase dark:bg-neutral-800 dark:text-neutral-300">
+                      {{ character.relationshipMode }}
+                    </span>
+                    <span class="rounded-full bg-amber-100 px-2 py-0.5 text-[10px] text-amber-700 font-medium tracking-wide uppercase dark:bg-amber-500/15 dark:text-amber-300">
+                      {{ character.visibility }}
+                    </span>
                   </div>
-                  <div class="flex items-center justify-end">
-                    <button
-                      type="button"
-                      class="flex flex-row items-center gap-1 rounded-full bg-neutral-900/65 pl-1.5 pr-2 py-1"
-                      @click="openCharacter(character.id)"
-                    >
-                      <div class="i-solar:chat-square-bold inline-block text-xs text-neutral-100" />
-                      <span class="text-xs text-neutral-100">Open</span>
-                    </button>
+
+                  <div class="line-clamp-3 max-h-[3rem] flex-1 overflow-hidden text-xs text-neutral-500">
+                    {{ character.personality || character.scenario || character.tagline }}
+                  </div>
+
+                  <div class="grid grid-cols-3 items-center">
+                    <div class="flex items-center justify-start">
+                      <Button variant="ghost" size="sm" aria-label="Bookmark" @click="characterStore.bookmark(character.id)">
+                        <div
+                          :class="[
+                            character.bookmarked ? 'i-solar-star-bold' : 'i-solar-star-linear',
+                            'inline-block text-base',
+                            character.bookmarked ? 'text-amber-300 dark:text-amber-500' : 'text-neutral-400',
+                          ]"
+                        />
+                        <span
+                          :class="[
+                            'text-xs',
+                            character.bookmarked ? 'text-amber-500 dark:text-amber-300' : 'text-neutral-500',
+                          ]"
+                        >
+                          {{ formatCount(character.bookmarks) }}
+                        </span>
+                      </Button>
+                    </div>
+                    <div class="flex items-center justify-center">
+                      <Button variant="ghost" size="sm" aria-label="Like" @click="characterStore.like(character.id)">
+                        <div
+                          :class="[
+                            character.liked ? 'i-solar-heart-bold' : 'i-solar-heart-outline',
+                            'inline-block text-base',
+                            character.liked ? 'text-rose-500 dark:text-rose-400' : 'text-neutral-400',
+                          ]"
+                        />
+                        <span
+                          :class="[
+                            'text-xs',
+                            character.liked ? 'text-rose-500 dark:text-rose-400' : 'text-neutral-500',
+                          ]"
+                        >
+                          {{ formatCount(character.likes) }}
+                        </span>
+                      </Button>
+                    </div>
+                    <div class="flex items-center justify-end">
+                      <button
+                        type="button"
+                        class="flex flex-row items-center gap-1 rounded-full bg-neutral-900/65 py-1 pl-1.5 pr-2"
+                        @click="openCharacter(character.id)"
+                      >
+                        <div class="i-solar:chat-square-bold inline-block text-xs text-neutral-100" />
+                        <span class="text-xs text-neutral-100">Open</span>
+                      </button>
+                    </div>
                   </div>
                 </div>
               </div>
             </div>
-          </div>
 
-          <div class="absolute left-0 top-0 z-0 h-full w-full">
-            <div class="absolute inset-0 z-2 h-full w-full bg-neutral-950/70 backdrop-blur-lg" />
-            <img
-              v-if="character.coverUrl"
-              :src="character.coverUrl"
-              :alt="character.name"
-              class="relative z-1 h-full w-full scale-300 object-contain transition duration-300 ease-in-out group-hover:scale-350"
-            >
-          </div>
-        </article>
-      </section>
+            <div class="absolute left-0 top-0 z-0 h-full w-full">
+              <div class="absolute inset-0 z-2 h-full w-full bg-neutral-950/70 backdrop-blur-lg" />
+              <img
+                v-if="character.coverUrl"
+                :src="character.coverUrl"
+                :alt="character.name"
+                class="relative z-1 h-full w-full scale-300 object-contain transition duration-300 ease-in-out group-hover:scale-350"
+              >
+            </div>
+          </article>
+        </section>
       </template>
     </div>
   </div>
diff --git a/packages/stage-pages/src/pages/v2/[id].vue b/packages/stage-pages/src/pages/v2/[id].vue
index fddda82101..92d7761418 100644
--- a/packages/stage-pages/src/pages/v2/[id].vue
+++ b/packages/stage-pages/src/pages/v2/[id].vue
@@ -81,19 +81,19 @@ async function enterStage() {
       </div>
 
       <div v-else class="grid gap-6 lg:grid-cols-[1.15fr,0.85fr]">
-        <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-neutral-950 via-neutral-900 to-rose-950 text-white shadow-sm">
+        <section class="bg-linear-to-br relative overflow-hidden rounded-[2rem] from-neutral-950 via-neutral-900 to-rose-950 text-white shadow-sm">
           <img
             :src="character.coverUrl"
             :alt="i18n.name"
             class="absolute inset-0 h-full w-full object-cover opacity-40"
           >
-          <div class="absolute inset-0 bg-linear-to-t from-black via-black/45 to-transparent" />
-          <div class="relative z-1 flex min-h-[34rem] flex-col justify-end gap-5 p-6 md:p-8">
+          <div class="bg-linear-to-t absolute inset-0 from-black via-black/45 to-transparent" />
+          <div class="relative z-1 min-h-[34rem] flex flex-col justify-end gap-5 p-6 md:p-8">
             <div class="flex flex-wrap gap-2">
               <span
                 v-for="badge in badges"
                 :key="badge"
-                class="rounded-full bg-white/12 px-3 py-1 text-[11px] font-medium uppercase tracking-[0.16em] backdrop-blur"
+                class="rounded-full bg-white/12 px-3 py-1 text-[11px] font-medium tracking-[0.16em] uppercase backdrop-blur"
               >
                 {{ badge }}
               </span>
@@ -110,7 +110,7 @@ async function enterStage() {
 
             <div class="grid gap-3 sm:grid-cols-3">
               <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
-                <div class="text-[11px] text-white/60 uppercase tracking-[0.16em]">
+                <div class="text-[11px] text-white/60 tracking-[0.16em] uppercase">
                   Dynamic
                 </div>
                 <div class="mt-1 text-sm font-medium">
@@ -118,7 +118,7 @@ async function enterStage() {
                 </div>
               </div>
               <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
-                <div class="text-[11px] text-white/60 uppercase tracking-[0.16em]">
+                <div class="text-[11px] text-white/60 tracking-[0.16em] uppercase">
                   Personality
                 </div>
                 <div class="mt-1 text-sm font-medium">
@@ -126,7 +126,7 @@ async function enterStage() {
                 </div>
               </div>
               <div class="rounded-2xl bg-white/10 px-4 py-3 backdrop-blur">
-                <div class="text-[11px] text-white/60 uppercase tracking-[0.16em]">
+                <div class="text-[11px] text-white/60 tracking-[0.16em] uppercase">
                   Access
                 </div>
                 <div class="mt-1 text-sm font-medium">
@@ -196,12 +196,12 @@ async function enterStage() {
             <h2 class="text-lg font-semibold">
               Engagement
             </h2>
-            <div class="mt-4 grid grid-cols-3 gap-3">
+            <div class="grid grid-cols-3 mt-4 gap-3">
               <div class="rounded-2xl bg-neutral-50 px-4 py-3 text-center dark:bg-neutral-800">
                 <div class="text-xl font-semibold">
                   {{ character.likesCount }}
                 </div>
-                <div class="text-xs text-neutral-500 uppercase tracking-wide dark:text-neutral-400">
+                <div class="text-xs text-neutral-500 tracking-wide uppercase dark:text-neutral-400">
                   Likes
                 </div>
               </div>
@@ -209,7 +209,7 @@ async function enterStage() {
                 <div class="text-xl font-semibold">
                   {{ character.bookmarksCount }}
                 </div>
-                <div class="text-xs text-neutral-500 uppercase tracking-wide dark:text-neutral-400">
+                <div class="text-xs text-neutral-500 tracking-wide uppercase dark:text-neutral-400">
                   Saves
                 </div>
               </div>
@@ -217,7 +217,7 @@ async function enterStage() {
                 <div class="text-xl font-semibold">
                   {{ character.interactionsCount }}
                 </div>
-                <div class="text-xs text-neutral-500 uppercase tracking-wide dark:text-neutral-400">
+                <div class="text-xs text-neutral-500 tracking-wide uppercase dark:text-neutral-400">
                   Chats
                 </div>
               </div>
diff --git a/packages/stage-pages/src/pages/v2/index.vue b/packages/stage-pages/src/pages/v2/index.vue
index 3610f91c8d..dc76c41a23 100644
--- a/packages/stage-pages/src/pages/v2/index.vue
+++ b/packages/stage-pages/src/pages/v2/index.vue
@@ -55,32 +55,32 @@ const characters = computed(() => Array.from(characterStore.characters.values())
     return char.relationshipMode === activeFilter.value
   })
   .map((char) => {
-  const i18n = char.i18n?.[0] || { name: 'Unknown', tagline: '', description: '' }
+    const i18n = char.i18n?.[0] || { name: 'Unknown', tagline: '', description: '' }
 
-  return {
-    id: char.id,
-    name: i18n.name,
-    tagline: i18n.tagline || i18n.description,
-    avatarUrl: char.avatarUrl || 'https://images.unsplash.com/photo-1524504388940-b1c1722653e1?auto=format&fit=crop&w=200&q=80',
-    characterAvatarUrl: char.characterAvatarUrl || characterAvatarImage,
-    coverUrl: char.coverUrl || coverImage,
-    coverBackgroundUrl: char.coverBackgroundUrl,
-    usedBy: char.interactionsCount,
-    interactions: char.interactionsCount,
-    likes: char.likesCount,
-    bookmarks: char.bookmarksCount,
-    forks: char.forksCount,
-    visibility: char.visibility,
-    nsfwEnabled: char.nsfwEnabled,
-    nsfwLevel: char.nsfwLevel,
-    relationshipMode: char.relationshipMode,
-    personality: char.personaProfile?.personality,
-    scenario: char.personaProfile?.scenario,
-    liked: char.likes?.some(l => l.userId === authStore.user?.id),
-    bookmarked: char.bookmarks?.some(b => b.userId === authStore.user?.id),
-    priceCredit: char.priceCredit,
-  }
-}))
+    return {
+      id: char.id,
+      name: i18n.name,
+      tagline: i18n.tagline || i18n.description,
+      avatarUrl: char.avatarUrl || 'https://images.unsplash.com/photo-1524504388940-b1c1722653e1?auto=format&fit=crop&w=200&q=80',
+      characterAvatarUrl: char.characterAvatarUrl || characterAvatarImage,
+      coverUrl: char.coverUrl || coverImage,
+      coverBackgroundUrl: char.coverBackgroundUrl,
+      usedBy: char.interactionsCount,
+      interactions: char.interactionsCount,
+      likes: char.likesCount,
+      bookmarks: char.bookmarksCount,
+      forks: char.forksCount,
+      visibility: char.visibility,
+      nsfwEnabled: char.nsfwEnabled,
+      nsfwLevel: char.nsfwLevel,
+      relationshipMode: char.relationshipMode,
+      personality: char.personaProfile?.personality,
+      scenario: char.personaProfile?.scenario,
+      liked: char.likes?.some(l => l.userId === authStore.user?.id),
+      bookmarked: char.bookmarks?.some(b => b.userId === authStore.user?.id),
+      priceCredit: char.priceCredit,
+    }
+  }))
 
 const filters = [
   { id: 'all', label: 'All' },
@@ -94,7 +94,7 @@ const filters = [
 <template>
   <div :class="['min-h-screen w-full px-4 py-8 md:px-8']">
     <div mx-auto max-w-7xl>
-      <section class="relative overflow-hidden rounded-[2rem] bg-linear-to-br from-rose-50 via-white to-amber-50 px-6 py-8 shadow-sm ring-1 ring-neutral-200/70 md:px-10 md:py-12 dark:from-neutral-950 dark:via-neutral-900 dark:to-neutral-950 dark:ring-neutral-800">
+      <section class="bg-linear-to-br relative overflow-hidden rounded-[2rem] from-rose-50 via-white to-amber-50 px-6 py-8 shadow-sm ring-1 ring-neutral-200/70 dark:from-neutral-950 dark:via-neutral-900 dark:to-neutral-950 md:px-10 md:py-12 dark:ring-neutral-800">
         <div class="absolute right--10 top--10 h-56 w-56 rounded-full bg-rose-300/20 blur-3xl dark:bg-rose-500/10" />
         <div class="absolute bottom--14 left-10 h-48 w-48 rounded-full bg-amber-300/20 blur-3xl dark:bg-amber-500/10" />
         <div relative z-1 max-w-3xl>
@@ -124,7 +124,7 @@ const filters = [
         </div>
       </section>
 
-      <div class="mt-8 grid gap-6 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5">
+      <div class="grid mt-8 gap-6 lg:grid-cols-4 md:grid-cols-3 sm:grid-cols-2 xl:grid-cols-5">
         <article
           v-for="character in characters"
           :key="character.id"
@@ -226,16 +226,16 @@ const filters = [
                   </button>
                 </div>
                 <div class="flex flex-wrap gap-1.5">
-                  <span class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] text-neutral-600 font-medium uppercase tracking-wide dark:bg-neutral-800 dark:text-neutral-300">
+                  <span class="rounded-full bg-neutral-100 px-2 py-0.5 text-[10px] text-neutral-600 font-medium tracking-wide uppercase dark:bg-neutral-800 dark:text-neutral-300">
                     {{ character.relationshipMode }}
                   </span>
                   <span
                     v-if="character.nsfwEnabled"
-                    class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] text-rose-700 font-medium uppercase tracking-wide dark:bg-rose-500/15 dark:text-rose-300"
+                    class="rounded-full bg-rose-100 px-2 py-0.5 text-[10px] text-rose-700 font-medium tracking-wide uppercase dark:bg-rose-500/15 dark:text-rose-300"
                   >
                     {{ character.nsfwLevel }}
                   </span>
-                  <span class="rounded-full bg-amber-100 px-2 py-0.5 text-[10px] text-amber-700 font-medium uppercase tracking-wide dark:bg-amber-500/15 dark:text-amber-300">
+                  <span class="rounded-full bg-amber-100 px-2 py-0.5 text-[10px] text-amber-700 font-medium tracking-wide uppercase dark:bg-amber-500/15 dark:text-amber-300">
                     {{ character.visibility }}
                   </span>
                 </div>
diff --git a/packages/stage-ui/src/libs/hermes.ts b/packages/stage-ui/src/libs/hermes.ts
index e920266cbf..ba671a95e8 100644
--- a/packages/stage-ui/src/libs/hermes.ts
+++ b/packages/stage-ui/src/libs/hermes.ts
@@ -5,8 +5,9 @@ import type {
   HermesReplyRequest,
   HermesUserContext,
 } from '@proj-airi/server-sdk-shared'
-import type { ChatHistoryItem } from '../types/chat'
+
 import type { Character } from '../types/character'
+import type { ChatHistoryItem } from '../types/chat'
 
 import { nanoid } from 'nanoid'
 
diff --git a/packages/stage-ui/src/stores/characters.ts b/packages/stage-ui/src/stores/characters.ts
index 251c1659ad..526db69621 100644
--- a/packages/stage-ui/src/stores/characters.ts
+++ b/packages/stage-ui/src/stores/characters.ts
@@ -1,4 +1,5 @@
 import type { Card } from '@proj-airi/ccc'
+
 import type { Character, CreateCharacterPayload, UpdateCharacterPayload } from '../types/character'
 
 import { useLocalStorage } from '@vueuse/core'
diff --git a/packages/stage-ui/src/stores/chat/hermes-memory-store.ts b/packages/stage-ui/src/stores/chat/hermes-memory-store.ts
index 4930204e34..b489cedd90 100644
--- a/packages/stage-ui/src/stores/chat/hermes-memory-store.ts
+++ b/packages/stage-ui/src/stores/chat/hermes-memory-store.ts
@@ -1,8 +1,9 @@
 import type { HermesReplyResponse } from '@proj-airi/server-sdk-shared'
+
 import type { ContextMessage } from '../../types/chat'
 
-import { StorageSerializers, useLocalStorage } from '@vueuse/core'
 import { ContextUpdateStrategy } from '@proj-airi/server-sdk'
+import { StorageSerializers, useLocalStorage } from '@vueuse/core'
 import { nanoid } from 'nanoid'
 import { defineStore } from 'pinia'
 
diff --git a/scripts/airi-web.sh b/scripts/airi-web.sh
new file mode 100755
index 0000000000..cb8e99a843
--- /dev/null
+++ b/scripts/airi-web.sh
@@ -0,0 +1,140 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PORT="${AIRI_WEB_PORT:-4173}"
+HOST="${AIRI_WEB_HOST:-127.0.0.1}"
+RUNTIME_DIR="${AIRI_WEB_RUNTIME_DIR:-$HOME/.cache/airi/stage-web}"
+PID_FILE="$RUNTIME_DIR/pid"
+LOG_FILE="$RUNTIME_DIR/server.log"
+
+mkdir -p "$RUNTIME_DIR"
+
+log() {
+  printf '[AIRI Web] %s\n' "$*"
+}
+
+is_running() {
+  if [[ -f "$PID_FILE" ]]; then
+    local pid
+    pid="$(cat "$PID_FILE")"
+    if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
+      return 0
+    fi
+  fi
+  return 1
+}
+
+cleanup_stale_pid() {
+  if [[ -f "$PID_FILE" ]] && ! is_running; then
+    rm -f "$PID_FILE"
+  fi
+}
+
+port_in_use() {
+  ss -ltn "( sport = :$PORT )" 2>/dev/null | tail -n +2 | grep -q .
+}
+
+start() {
+  cleanup_stale_pid
+
+  if is_running; then
+    log "already running on http://$HOST:$PORT (pid $(cat "$PID_FILE"))"
+    return 0
+  fi
+
+  if port_in_use; then
+    log "port $PORT is already in use"
+    return 1
+  fi
+
+  log "starting on http://$HOST:$PORT"
+  (
+    cd /home/faramix/airi
+    exec pnpm -F @proj-airi/stage-web exec vite --host "$HOST" --port "$PORT" --strictPort
+  ) >>"$LOG_FILE" 2>&1 &
+  local pid=$!
+  echo "$pid" > "$PID_FILE"
+
+  for _ in {1..30}; do
+    if ! kill -0 "$pid" 2>/dev/null; then
+      log "failed to start; check $LOG_FILE"
+      rm -f "$PID_FILE"
+      return 1
+    fi
+
+    if port_in_use; then
+      log "ready on http://$HOST:$PORT"
+      return 0
+    fi
+
+    sleep 1
+  done
+
+  log "timed out waiting for port $PORT; check $LOG_FILE"
+  return 1
+}
+
+stop() {
+  cleanup_stale_pid
+
+  if ! is_running; then
+    log "not running"
+    return 0
+  fi
+
+  local pid
+  pid="$(cat "$PID_FILE")"
+  log "stopping pid $pid"
+  kill "$pid" 2>/dev/null || true
+
+  for _ in {1..10}; do
+    if ! kill -0 "$pid" 2>/dev/null; then
+      rm -f "$PID_FILE"
+      log "stopped"
+      return 0
+    fi
+    sleep 1
+  done
+
+  log "process did not stop cleanly"
+  return 1
+}
+
+status() {
+  cleanup_stale_pid
+
+  if is_running; then
+    log "running on http://$HOST:$PORT (pid $(cat "$PID_FILE"))"
+    return 0
+  fi
+
+  if port_in_use; then
+    log "port $PORT is busy, but not owned by this launcher"
+    return 1
+  fi
+
+  log "stopped"
+}
+
+logs() {
+  if [[ -f "$LOG_FILE" ]]; then
+    tail -n 200 "$LOG_FILE"
+  else
+    log "no log file yet"
+  fi
+}
+
+case "${1:-start}" in
+  start) start ;;
+  stop) stop ;;
+  status) status ;;
+  logs) logs ;;
+  restart)
+    stop || true
+    start
+    ;;
+  *)
+    log "usage: $0 {start|stop|status|logs|restart}"
+    exit 1
+    ;;
+esac
diff --git a/scripts/ci/pnpm-install.sh b/scripts/ci/pnpm-install.sh
new file mode 100644
index 0000000000..2f1cf36f0e
--- /dev/null
+++ b/scripts/ci/pnpm-install.sh
@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+attempts="${CI_PNPM_INSTALL_RETRIES:-3}"
+base_delay_sec="${CI_PNPM_INSTALL_DELAY_SEC:-10}"
+
+# CI only needs package metadata for these jobs; skipping heavyweight downloads
+# makes installs less flaky when upstream mirrors return transient 5xx responses.
+export ELECTRON_SKIP_BINARY_DOWNLOAD="${ELECTRON_SKIP_BINARY_DOWNLOAD:-1}"
+export PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="${PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD:-1}"
+export npm_config_fetch_retries="${npm_config_fetch_retries:-5}"
+export npm_config_fetch_retry_factor="${npm_config_fetch_retry_factor:-2}"
+export npm_config_fetch_retry_mintimeout="${npm_config_fetch_retry_mintimeout:-10000}"
+export npm_config_fetch_retry_maxtimeout="${npm_config_fetch_retry_maxtimeout:-120000}"
+
+for attempt in $(seq 1 "$attempts"); do
+  echo "[ci-install] pnpm install attempt ${attempt}/${attempts}"
+  if pnpm install --frozen-lockfile; then
+    exit 0
+  fi
+
+  if [ "$attempt" -eq "$attempts" ]; then
+    echo "[ci-install] pnpm install failed after ${attempts} attempts" >&2
+    exit 1
+  fi
+
+  sleep_sec=$((base_delay_sec * attempt))
+  echo "[ci-install] retrying in ${sleep_sec}s"
+  sleep "$sleep_sec"
+done

From 0f17c5292f32ebd0cb5ec900f22b6399deaf2ce7 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Mon, 6 Apr 2026 22:40:02 +0200
Subject: [PATCH 27/30] chore: add keystore files to .gitignore

Security: exclude Android keystore files from version control

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .gitignore | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.gitignore b/.gitignore
index 76e812aeb8..4d02f5f3a5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -133,3 +133,7 @@ apps/stage-tamagotchi/electron.vite.config.*.mjs
 
 # Tools - Obsidian
 .obsidian/
+
+# Android keystore (secrets)
+apps/stage-pocket/*.jks
+apps/stage-pocket/*base64.txt

From a3c9d93aecb59f8e9ba0b8b69637f9d8225ea1e4 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Fri, 10 Apr 2026 03:50:38 +0200
Subject: [PATCH 28/30] ci: fix invalid macos-26 runner to macos-14

---
 .github/workflows/release-tamagotchi.yml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/release-tamagotchi.yml b/.github/workflows/release-tamagotchi.yml
index a93dc875ad..a7c45726ae 100644
--- a/.github/workflows/release-tamagotchi.yml
+++ b/.github/workflows/release-tamagotchi.yml
@@ -60,7 +60,7 @@ jobs:
             builder-args: --macos --x64
             skip: ${{ inputs.platform != '' && inputs.platform != 'all' && inputs.platform != 'macos' }}
 
-          - os: macos-26
+          - os: macos-14
             artifact: darwin-arm64
             target: aarch64-apple-darwin
             builder-args: --macos --arm64
@@ -108,13 +108,13 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: macOS Select Xcode 26.2
-        if: matrix.os == 'macos-15-intel' || matrix.os == 'macos-26'
+        if: matrix.os == 'macos-15-intel' || matrix.os == 'macos-14'
         run: |
           sudo xcode-select -s /Applications/Xcode_26.2.app
           xcodebuild -version
 
       - name: macOS Show Toolchain
-        if: matrix.os == 'macos-15-intel' || matrix.os == 'macos-26'
+        if: matrix.os == 'macos-15-intel' || matrix.os == 'macos-14'
         run: |
           xcodebuild -version
           actool --version
@@ -141,7 +141,7 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Build (macOS Only) # macOS
-        if: matrix.os == 'macos-15-intel' || matrix.os == 'macos-26'
+        if: matrix.os == 'macos-15-intel' || matrix.os == 'macos-14'
         run: |
           echo "$CSC_CONTENT" | base64 --decode > apps/stage-tamagotchi/apple-developer-code-signing.p12
           export CSC_LINK="./apple-developer-code-signing.p12"
@@ -197,7 +197,7 @@ jobs:
           echo "VERSION=$(pnpm exec tsx scripts/artifacts-metadata.ts ${{ matrix.target }} --get-version)" >> $GITHUB_ENV
 
       - name: Get Artifacts Envs (Nightly + macOS Only)
-        if: ${{ github.event_name == 'schedule' && (matrix.os == 'macos-26' || matrix.os == 'macos-15-intel') }}
+        if: ${{ github.event_name == 'schedule' && (matrix.os == 'macos-14' || matrix.os == 'macos-15-intel') }}
         working-directory: ./apps/stage-tamagotchi
         run: |
           echo "BUNDLE_NAME=$(pnpm exec tsx scripts/artifacts-metadata.ts ${{ matrix.target }} --get-bundle-name)" >> $GITHUB_ENV
@@ -294,7 +294,7 @@ jobs:
           echo "VERSION=$(pnpm exec tsx scripts/artifacts-metadata.ts ${{ matrix.target }} --get-version --release ${{ !inputs.build_only && !inputs.artifacts_only }} --tag ${{ inputs.tag }} --auto-tag ${{ !inputs.build_only }})" >> $GITHUB_ENV
 
       - name: Get Artifacts Envs (Manual + macOS Only)
-        if: ${{ github.event_name == 'workflow_dispatch' && (matrix.os == 'macos-26' || matrix.os == 'macos-15-intel') }}
+        if: ${{ github.event_name == 'workflow_dispatch' && (matrix.os == 'macos-14' || matrix.os == 'macos-15-intel') }}
         working-directory: ./apps/stage-tamagotchi
         run: |
           echo "BUNDLE_NAME=$(pnpm exec tsx scripts/artifacts-metadata.ts ${{ matrix.target }} --get-bundle-name --release ${{ !inputs.build_only && !inputs.artifacts_only }} --tag ${{ inputs.tag }} --auto-tag ${{ !inputs.build_only }})" >> $GITHUB_ENV
@@ -468,7 +468,7 @@ jobs:
 
       # https://itch.io/docs/butler/pushing.html
       - name: Upload macOS (arm64) to itch.io
-        if: ${{ github.event_name == 'release' && matrix.os == 'macos-26' }}
+        if: ${{ github.event_name == 'release' && matrix.os == 'macos-14' }}
         run: butler push apps/stage-tamagotchi/bundle/${{ env.BUNDLE_NAME }} nekomeowww/airi:osx --userversion ${{ env.VERSION }}
         env:
           BUTLER_API_KEY: ${{ secrets.GAME_PUBLISHING_ITCHIO }}

From 52f29d696ba46e86a5f523d202968371baf07a9e Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Fri, 10 Apr 2026 03:52:55 +0200
Subject: [PATCH 29/30] ci: upgrade pnpm/action-setup to v5 and skip
 free-disk-space on arm runners

---
 .github/workflows/release-tamagotchi.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/release-tamagotchi.yml b/.github/workflows/release-tamagotchi.yml
index a7c45726ae..36395abcd2 100644
--- a/.github/workflows/release-tamagotchi.yml
+++ b/.github/workflows/release-tamagotchi.yml
@@ -102,7 +102,7 @@ jobs:
       # failed to build archive at `/home/runner/work/airi/airi/target/x86_64-unknown-linux-gnu/release/deps/libapp_lib.rlib`:
       # No space left on device (os error 28)
       - name: Free Disk Space
-        if: matrix.os == 'ubuntu-latest' || matrix.os == 'ubuntu-24.04-arm'
+        if: matrix.os == 'ubuntu-latest'
         uses: jlumbroso/free-disk-space@main
 
       - uses: actions/checkout@v6
@@ -484,3 +484,5 @@ jobs:
         run: butler push apps/stage-tamagotchi/bundle/${{ env.BUNDLE_NAME }} nekomeowww/airi:linux --userversion ${{ env.VERSION }}
         env:
           BUTLER_API_KEY: ${{ secrets.GAME_PUBLISHING_ITCHIO }}
+ env:
+          BUTLER_API_KEY: ${{ secrets.GAME_PUBLISHING_ITCHIO }}

From 5ef02d1dd8e83eb8bde36982ffb2b24b26766e77 Mon Sep 17 00:00:00 2001
From: faramix <roseonlineownz@gmail.com>
Date: Tue, 14 Apr 2026 18:42:25 +0200
Subject: [PATCH 30/30] fix: make OAuth credentials optional for AIRI server

- Change AUTH_GOOGLE_CLIENT_ID/SECRET and AUTH_GITHUB_CLIENT_ID/SECRET
  from required to optional with empty string defaults
- Conditionally include social providers only when credentials are set
- Server starts cleanly without OAuth configured (social login disabled)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 apps/server/src/libs/auth.ts | 14 ++++++--------
 apps/server/src/libs/env.ts  |  8 ++++----
 2 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/apps/server/src/libs/auth.ts b/apps/server/src/libs/auth.ts
index 3284696fee..fff1c56233 100644
--- a/apps/server/src/libs/auth.ts
+++ b/apps/server/src/libs/auth.ts
@@ -357,14 +357,12 @@ export function createAuth(db: Database, env: Env, metrics?: AuthMetrics | null)
     },
 
     socialProviders: {
-      google: {
-        clientId: env.AUTH_GOOGLE_CLIENT_ID,
-        clientSecret: env.AUTH_GOOGLE_CLIENT_SECRET,
-      },
-      github: {
-        clientId: env.AUTH_GITHUB_CLIENT_ID,
-        clientSecret: env.AUTH_GITHUB_CLIENT_SECRET,
-      },
+      ...(env.AUTH_GOOGLE_CLIENT_ID && env.AUTH_GOOGLE_CLIENT_SECRET
+        ? { google: { clientId: env.AUTH_GOOGLE_CLIENT_ID, clientSecret: env.AUTH_GOOGLE_CLIENT_SECRET } }
+        : {}),
+      ...(env.AUTH_GITHUB_CLIENT_ID && env.AUTH_GITHUB_CLIENT_SECRET
+        ? { github: { clientId: env.AUTH_GITHUB_CLIENT_ID, clientSecret: env.AUTH_GITHUB_CLIENT_SECRET } }
+        : {}),
     },
 
     hooks: {
diff --git a/apps/server/src/libs/env.ts b/apps/server/src/libs/env.ts
index 0f27774989..0c53c81283 100644
--- a/apps/server/src/libs/env.ts
+++ b/apps/server/src/libs/env.ts
@@ -43,10 +43,10 @@ const EnvSchema = object({
   DATABASE_URL: pipe(string(), nonEmpty('DATABASE_URL is required')),
   REDIS_URL: pipe(string(), nonEmpty('REDIS_URL is required')),
 
-  AUTH_GOOGLE_CLIENT_ID: pipe(string(), nonEmpty('AUTH_GOOGLE_CLIENT_ID is required')),
-  AUTH_GOOGLE_CLIENT_SECRET: pipe(string(), nonEmpty('AUTH_GOOGLE_CLIENT_SECRET is required')),
-  AUTH_GITHUB_CLIENT_ID: pipe(string(), nonEmpty('AUTH_GITHUB_CLIENT_ID is required')),
-  AUTH_GITHUB_CLIENT_SECRET: pipe(string(), nonEmpty('AUTH_GITHUB_CLIENT_SECRET is required')),
+  AUTH_GOOGLE_CLIENT_ID: optional(string(), ''),
+  AUTH_GOOGLE_CLIENT_SECRET: optional(string(), ''),
+  AUTH_GITHUB_CLIENT_ID: optional(string(), ''),
+  AUTH_GITHUB_CLIENT_SECRET: optional(string(), ''),
 
   STRIPE_SECRET_KEY: optional(string()),
   STRIPE_WEBHOOK_SECRET: optional(string()),