feat: Sprint V-3 — Content Templates for entity creation

Add content templates that pre-fill the editor with structured content
when creating entities. Templates can be campaign-scoped or global, and
optionally bound to specific entity types.

Backend:
- Migration 000003: content_templates table with campaign/entity type FKs
- ContentTemplate model, repository (CRUD with campaign+type filtering),
  service (validation, seeding), handler (REST API), routes
- ContentTemplateSeeder interface on campaigns for auto-seeding on create
- 4 default templates: Session Recap, NPC Profile, Location, Quest Log
- Entity Create handler applies template content on creation

Frontend:
- Template picker dropdown on entity create form (loads via API on type select)
- "Insert Template" slash command in editor (/ menu) with floating picker
- SlashCommands.addCommand() for dynamic command registration
- template_picker.js: form picker + editor insert menu logic

Customization Hub:
- New "Content Templates" tab with Alpine.js CRUD interface
- Create/edit/delete campaign templates with icon picker
- Built-in templates shown as read-only

https://claude.ai/code/session_01QJLkgjQDu5qohzJKGV4hj9

Author: claude

.ai/status.md

@@ -8,6 +8,21 @@
 <!-- ====================================================================== -->
 
 ## Last Updated
+2026-03-10 -- **Sprint V-3: Content Templates (COMPLETE).**
+
+12. **Content templates migration**: `content_templates` table with campaign_id FK, entity_type_id FK, TipTap JSON/HTML content, icon, sort order, and global flag.
+
+13. **Content template CRUD**: `ContentTemplateRepository` (Create, FindByID, ListForCampaign, ListForCampaignAndType, Update, Delete), `ContentTemplateService` (validation, CRUD, SeedDefaults), `ContentTemplateHandler` (REST API: GET/POST/PUT/DELETE at `/content-templates`).
+
+14. **Template picker on entity create form**: Dropdown appears when entity type is selected, populated via API. Selected template content is applied to the entity entry after creation.
+
+15. **Editor slash command**: `/template` or `/insert template` in the editor shows a floating menu of available templates. Selecting one inserts the template's ProseMirror content at the cursor position.
+
+16. **Default templates**: Four built-in templates (Session Recap, NPC Profile, Location, Quest Log) are seeded on campaign creation via `ContentTemplateSeeder` interface.
+
+17. **Customization Hub tab**: "Content Templates" tab shows all campaign templates with create/edit/delete for campaign-scoped templates. Built-in templates show read-only badge.
+
+### Previous Update
 2026-03-10 -- **Cleanup & consolidation pass after bug fixes.**
 
 7. **JSON injection fix**: HX-Trigger header in `CreateEntityType` error path used string concatenation to build JSON. Replaced with `json.Marshal()` to prevent malformed JSON from error messages containing special characters.

.ai/todo.md

@@ -201,7 +201,7 @@ _Quick capture, backlinks, enhanced graph, editor power-ups. See `.ai/obsidian-n
 - [x] **Sprint V-1.5: Inline Secrets / DM-Only Blocks in Editor** — SecretMark TipTap extension (Ctrl+Shift+S toggle), `sanitize.StripSecretsHTML/JSON` server-side stripping for non-Scribe, `.chronicle-secret` CSS with amber eye-slash icon, toolbar button. Already implemented alongside V-1.
 - [x] **Sprint V-2: Backlinks Panel & Entity Aliases** — HTMX lazy-loaded backlinks with Redis caching + context snippets. Entity aliases table (migration 061), alias CRUD API, aliases widget (tag chips), search/auto-linker/mention integration via `ListNames()` UNION. 11 new tests.
 - [x] **Full-Page Journal & Category Nav Redesign** — Full-page journal view at `/campaigns/:id/journal` with two-panel Obsidian-like layout (note tree sidebar + TipTap editor, search, folder tabs, autosave). Journal link in sidebar nav (gated on notes addon). Notes FAB hidden on journal page to avoid sync conflicts. Removed "Session Journal" topbar button. Redesigned sidebar drill panel: merged header + action bar into compact clickable row (category name opens full page, replacing "View All"), count as pill badge, inline "+" button. Entity tree: folder/page icons, guide lines, smooth transitions, distinct reorder vs reparent D&D feedback.
-- [ ] **Sprint V-3: Content Templates** — Pre-fill editor with structured content (Session Recap, etc.). Template picker in create flow + editor insert.
+- [x] **Sprint V-3: Content Templates** — `content_templates` table, ContentTemplateService with CRUD + seeding, REST API, template picker on entity create form (loads by entity type), "Insert Template" slash command in editor, 4 default templates (Session Recap, NPC Profile, Location, Quest Log) seeded on campaign creation, Customization Hub "Content Templates" tab for management.
 - [ ] **Sprint V-4: Enhanced Graph View & Cover Images** — @mention links in graph, entity type/tag filtering, local graph (N hops), clustering, orphan detection. Cover/banner image layout block type for entity pages.
 - [ ] **Sprint V-5: Session Journal Audio Attachments** — Audio file upload support in Session Journal notes. Users can attach audio recordings (voice memos, session recordings, ambient tracks) to session notes. Privacy controls: share audio with session participants (public to group) or keep private (visible only to uploader). Media plugin integration for storage/serving. Allowed MIME types: audio/mpeg, audio/ogg, audio/wav, audio/webm. Inline audio player in note view. Migration for audio attachment metadata.
 

db/migrations/000003_content_templates.down.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS content_templates;

db/migrations/000003_content_templates.up.sql

@@ -0,0 +1,25 @@
+-- Content templates provide pre-filled editor content for entity creation.
+-- Templates can be global (is_global=1, campaign_id IS NULL) or per-campaign.
+CREATE TABLE IF NOT EXISTS content_templates (
+    id              INT AUTO_INCREMENT PRIMARY KEY,
+    campaign_id     CHAR(36) NULL,
+    entity_type_id  INT NULL,
+    name            VARCHAR(200) NOT NULL,
+    description     VARCHAR(500) NOT NULL DEFAULT '',
+    content_json    JSON NOT NULL,
+    content_html    TEXT NOT NULL DEFAULT '',
+    icon            VARCHAR(50) NOT NULL DEFAULT 'fa-file-lines',
+    sort_order      INT NOT NULL DEFAULT 0,
+    is_global       BOOLEAN NOT NULL DEFAULT FALSE,
+    created_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+    INDEX idx_ct_campaign (campaign_id),
+    INDEX idx_ct_entity_type (entity_type_id),
+    INDEX idx_ct_global (is_global),
+
+    CONSTRAINT fk_ct_campaign FOREIGN KEY (campaign_id)
+        REFERENCES campaigns(id) ON DELETE CASCADE,
+    CONSTRAINT fk_ct_entity_type FOREIGN KEY (entity_type_id)
+        REFERENCES entity_types(id) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

internal/app/routes.go

@@ -705,6 +705,14 @@ func (a *App) RegisterRoutes() {
 	entityHandler := entities.NewHandler(entityService)
 	entities.RegisterRoutes(e, entityHandler, campaignService, authService)
 
+	// Content template routes (entity content blueprints).
+	contentTemplateRepo := entities.NewContentTemplateRepository(a.DB)
+	contentTemplateService := entities.NewContentTemplateService(contentTemplateRepo, entityTypeRepo)
+	contentTemplateHandler := entities.NewContentTemplateHandler(contentTemplateService)
+	entities.RegisterContentTemplateRoutes(e, contentTemplateHandler, campaignService, authService)
+	campaignService.SetContentTemplateSeeder(contentTemplateService)
+	entityHandler.SetContentTemplateService(contentTemplateService)
+
 	// Media plugin: file upload, storage, thumbnailing, serving.
 	// Graceful degradation: if the media directory can't be created, log a warning
 	// but don't crash -- the rest of the app keeps running.

internal/plugins/campaigns/customize.templ

@@ -76,6 +76,13 @@ templ CustomizePage(cc *CampaignContext, entityTypes []SettingsEntityType, csrfT
 				>
 					<i class="fa-solid fa-bars mr-1.5 text-xs"></i> Navigation
 				</button>
+				<button
+					class="px-4 py-2.5 text-sm font-medium border-b-2 transition-colors whitespace-nowrap"
+					:class="tab === 'content-templates' ? 'text-accent border-accent' : 'text-fg-secondary border-transparent hover:text-fg hover:border-edge'"
+					@click="tab = 'content-templates'"
+				>
+					<i class="fa-solid fa-file-lines mr-1.5 text-xs"></i> Content Templates
+				</button>
 				<button
 					class="px-4 py-2.5 text-sm font-medium border-b-2 transition-colors whitespace-nowrap"
 					:class="tab === 'extensions' ? 'text-accent border-accent' : 'text-fg-secondary border-transparent hover:text-fg hover:border-edge'"
@@ -111,6 +118,13 @@ templ CustomizePage(cc *CampaignContext, entityTypes []SettingsEntityType, csrfT
 					</div>
 				</div>
 
+				<!-- Content Templates tab: manage content templates for entity creation -->
+				<div x-show="tab === 'content-templates'" x-cloak class="h-full overflow-y-auto">
+					<div class="max-w-3xl mx-auto px-6 py-4">
+						@contentTemplatesTab(cc, csrfToken)
+					</div>
+				</div>
+
 				<!-- Extensions tab: enable/disable campaign addons + attributes editor -->
 				<div x-show="tab === 'extensions'" x-cloak class="h-full overflow-y-auto">
 					<div class="max-w-3xl mx-auto px-6 py-4">
@@ -477,3 +491,228 @@ templ LayoutEditorFragment(cc *CampaignContext, et *LayoutEditorEntityType, csrf
 		></div>
 	</div>
 }
+
+// contentTemplatesTab renders the content template management interface.
+// Templates are loaded via HTMX from the entities plugin's API.
+templ contentTemplatesTab(cc *CampaignContext, csrfToken string) {
+	<div class="space-y-4">
+		<div class="flex items-center justify-between">
+			<div>
+				<h2 class="text-base font-semibold text-fg mb-0.5">Content Templates</h2>
+				<p class="text-xs text-fg-secondary">
+					Pre-fill the editor when creating new pages. Templates appear in the create form and the editor's "/" menu.
+				</p>
+			</div>
+		</div>
+
+		// Template list and management (Alpine.js powered).
+		<div
+			x-data={ fmt.Sprintf(`{
+				templates: [],
+				loading: true,
+				editing: null,
+				creating: false,
+				form: { name: '', description: '', icon: 'fa-file-lines', entity_type_id: 0, content_json: '', content_html: '' },
+				async load() {
+					this.loading = true;
+					try {
+						var resp = await fetch('/campaigns/%s/content-templates', {
+							headers: { 'Accept': 'application/json' }
+						});
+						if (resp.ok) this.templates = await resp.json();
+					} finally { this.loading = false; }
+				},
+				async save() {
+					var url = '/campaigns/%s/content-templates';
+					var method = 'POST';
+					if (this.editing) {
+						url += '/' + this.editing;
+						method = 'PUT';
+					}
+					if (!this.form.content_json) {
+						this.form.content_json = '{"type":"doc","content":[{"type":"paragraph","content":[{"type":"text","text":"Start writing..."}]}]}';
+						this.form.content_html = '<p>Start writing...</p>';
+					}
+					var resp = await fetch(url, {
+						method: method,
+						headers: {
+							'Content-Type': 'application/json',
+							'X-CSRF-Token': '%s'
+						},
+						credentials: 'same-origin',
+						body: JSON.stringify(this.form)
+					});
+					if (resp.ok) {
+						this.editing = null;
+						this.creating = false;
+						this.form = { name: '', description: '', icon: 'fa-file-lines', entity_type_id: 0, content_json: '', content_html: '' };
+						this.load();
+						Chronicle.notify('Template saved.', 'success');
+					} else {
+						Chronicle.notify('Failed to save template.', 'error');
+					}
+				},
+				async remove(id) {
+					if (!confirm('Delete this template?')) return;
+					var resp = await fetch('/campaigns/%s/content-templates/' + id, {
+						method: 'DELETE',
+						headers: { 'X-CSRF-Token': '%s' },
+						credentials: 'same-origin'
+					});
+					if (resp.ok) {
+						this.load();
+						Chronicle.notify('Template deleted.', 'success');
+					}
+				},
+				edit(t) {
+					this.editing = t.id;
+					this.creating = true;
+					this.form = {
+						name: t.name,
+						description: t.description,
+						icon: t.icon,
+						entity_type_id: t.entity_type_id || 0,
+						content_json: t.content_json,
+						content_html: t.content_html
+					};
+				},
+				cancel() {
+					this.editing = null;
+					this.creating = false;
+					this.form = { name: '', description: '', icon: 'fa-file-lines', entity_type_id: 0, content_json: '', content_html: '' };
+				}
+			}`, cc.Campaign.ID, cc.Campaign.ID, csrfToken, cc.Campaign.ID, csrfToken) }
+			x-init="load()"
+		>
+			// Loading state.
+			<div x-show="loading" class="card p-6 text-center">
+				<i class="fa-solid fa-spinner fa-spin text-fg-muted"></i>
+				<span class="text-sm text-fg-muted ml-2">Loading templates...</span>
+			</div>
+
+			// Template list.
+			<div x-show="!loading && !creating" x-cloak>
+				<div class="space-y-2 mb-4">
+					<template x-for="t in templates" x-bind:key="t.id">
+						<div class="card p-4 flex items-center gap-3">
+							<span class="w-8 h-8 rounded-lg bg-accent/10 flex items-center justify-center shrink-0">
+								<i class="fa-solid text-accent text-sm" x-bind:class="t.icon || 'fa-file-lines'"></i>
+							</span>
+							<div class="flex-1 min-w-0">
+								<div class="font-medium text-sm text-fg truncate" x-text="t.name"></div>
+								<div class="text-xs text-fg-muted truncate" x-text="t.description || 'No description'"></div>
+								<div x-show="t.entity_type_name" class="text-[10px] text-fg-muted mt-0.5">
+									<i class="fa-solid fa-folder-open mr-0.5"></i>
+									<span x-text="t.entity_type_name"></span>
+								</div>
+							</div>
+							<div class="flex items-center gap-1 shrink-0">
+								<template x-if="!t.is_global">
+									<button
+										@click="edit(t)"
+										class="w-7 h-7 flex items-center justify-center rounded text-fg-muted hover:text-accent hover:bg-accent/10 transition-colors"
+										title="Edit"
+									>
+										<i class="fa-solid fa-pen text-xs"></i>
+									</button>
+								</template>
+								<template x-if="!t.is_global">
+									<button
+										@click="remove(t.id)"
+										class="w-7 h-7 flex items-center justify-center rounded text-fg-muted hover:text-red-500 hover:bg-red-50 dark:hover:bg-red-900/20 transition-colors"
+										title="Delete"
+									>
+										<i class="fa-solid fa-trash text-xs"></i>
+									</button>
+								</template>
+								<template x-if="t.is_global">
+									<span class="text-[10px] text-fg-muted bg-surface-alt px-2 py-0.5 rounded-full">Built-in</span>
+								</template>
+							</div>
+						</div>
+					</template>
+				</div>
+
+				<div x-show="templates.length === 0 && !loading" class="card p-6 text-center">
+					<i class="fa-solid fa-file-lines text-2xl text-fg-muted mb-2"></i>
+					<p class="text-sm text-fg-secondary">No content templates yet.</p>
+				</div>
+
+				<button
+					@click="creating = true"
+					class="btn-primary text-sm"
+				>
+					<i class="fa-solid fa-plus mr-1.5"></i> New Template
+				</button>
+			</div>
+
+			// Create / Edit form.
+			<div x-show="creating" x-cloak>
+				<div class="card p-6 space-y-4">
+					<h3 class="text-sm font-semibold text-fg" x-text="editing ? 'Edit Template' : 'New Template'"></h3>
+
+					<div>
+						<label class="block text-sm font-medium text-fg-body mb-1">Name</label>
+						<input
+							type="text"
+							x-model="form.name"
+							class="input w-full"
+							placeholder="e.g., Session Recap, NPC Profile"
+							maxlength="200"
+						/>
+					</div>
+
+					<div>
+						<label class="block text-sm font-medium text-fg-body mb-1">Description (optional)</label>
+						<input
+							type="text"
+							x-model="form.description"
+							class="input w-full"
+							placeholder="Brief description of what this template is for"
+							maxlength="500"
+						/>
+					</div>
+
+					<div>
+						<label class="block text-sm font-medium text-fg-body mb-1">Icon</label>
+						<select x-model="form.icon" class="input w-full">
+							<option value="fa-file-lines">File</option>
+							<option value="fa-scroll">Scroll</option>
+							<option value="fa-user">Person</option>
+							<option value="fa-location-dot">Location</option>
+							<option value="fa-list-check">Checklist</option>
+							<option value="fa-dragon">Dragon</option>
+							<option value="fa-shield-halved">Shield</option>
+							<option value="fa-book">Book</option>
+							<option value="fa-map">Map</option>
+							<option value="fa-crown">Crown</option>
+							<option value="fa-skull">Skull</option>
+							<option value="fa-wand-magic-sparkles">Magic</option>
+						</select>
+					</div>
+
+					<div>
+						<label class="block text-sm font-medium text-fg-body mb-1">Content (TipTap JSON)</label>
+						<textarea
+							x-model="form.content_json"
+							class="input w-full h-32 font-mono text-xs"
+							placeholder='{"type":"doc","content":[...]}'
+						></textarea>
+						<p class="mt-1 text-xs text-fg-secondary">
+							Paste TipTap/ProseMirror document JSON. To get this, create the template content in
+							any entity's editor, then copy the entry JSON from the browser developer tools.
+						</p>
+					</div>
+
+					<div class="flex items-center gap-3">
+						<button @click="save()" class="btn-primary text-sm">
+							<i class="fa-solid fa-check mr-1.5"></i>
+							<span x-text="editing ? 'Update' : 'Create'"></span>
+						</button>
+						<button @click="cancel()" class="btn-secondary text-sm">Cancel</button>
+					</div>
+				</div>
+			</div>
+		</div>
+	</div>
+}

internal/plugins/campaigns/model.go

@@ -381,6 +381,12 @@ type EntityTypeSeeder interface {
 	SeedDefaults(ctx context.Context, campaignID string) error
 }
 
+// ContentTemplateSeeder seeds default content templates when a campaign is
+// created. Implemented by the entities plugin's ContentTemplateService.
+type ContentTemplateSeeder interface {
+	SeedDefaults(ctx context.Context, campaignID string) error
+}
+
 // --- Request DTOs (bound from HTTP requests) ---
 
 // CreateCampaignRequest holds the data submitted by the campaign creation form.

internal/plugins/campaigns/service.go

@@ -67,6 +67,7 @@ type CampaignService interface {
 	AdminAddMember(ctx context.Context, campaignID, userID string, role Role) error
 
 	// Lifecycle hooks — set after construction to avoid circular initialization.
+	SetContentTemplateSeeder(seeder ContentTemplateSeeder)
 	SetMediaCleaner(cleaner MediaCleaner)
 	SetHookDispatcher(dispatcher CampaignHookDispatcher)
 }
@@ -100,10 +101,11 @@ type campaignService struct {
 	repo           CampaignRepository
 	users          UserFinder
 	mail           MailService            // May be nil if SMTP is not configured.
-	seeder         EntityTypeSeeder       // Seeds default entity types on campaign creation. May be nil.
-	mediaCleaner   MediaCleaner           // Cleans up media files on campaign delete. May be nil.
-	hookDispatcher CampaignHookDispatcher // Dispatches WASM lifecycle events. May be nil.
-	baseURL        string
+	seeder           EntityTypeSeeder       // Seeds default entity types on campaign creation. May be nil.
+	templateSeeder   ContentTemplateSeeder  // Seeds default content templates on campaign creation. May be nil.
+	mediaCleaner     MediaCleaner           // Cleans up media files on campaign delete. May be nil.
+	hookDispatcher   CampaignHookDispatcher // Dispatches WASM lifecycle events. May be nil.
+	baseURL          string
 }
 
 // NewCampaignService creates a new campaign service with the given dependencies.
@@ -118,6 +120,12 @@ func NewCampaignService(repo CampaignRepository, users UserFinder, mail MailServ
 	}
 }
 
+// SetContentTemplateSeeder sets the seeder for default content templates.
+// Called after all plugins are wired to avoid initialization order issues.
+func (s *campaignService) SetContentTemplateSeeder(seeder ContentTemplateSeeder) {
+	s.templateSeeder = seeder
+}
+
 // SetMediaCleaner sets the media cleaner for campaign deletion cleanup.
 // Called after all plugins are wired to avoid initialization order issues.
 func (s *campaignService) SetMediaCleaner(cleaner MediaCleaner) {
@@ -197,6 +205,16 @@ func (s *campaignService) Create(ctx context.Context, userID string, input Creat
 		}
 	}
 
+	// Seed default content templates for the new campaign.
+	if s.templateSeeder != nil {
+		if err := s.templateSeeder.SeedDefaults(ctx, campaign.ID); err != nil {
+			slog.Warn("failed to seed default content templates",
+				slog.String("campaign_id", campaign.ID),
+				slog.Any("error", err),
+			)
+		}
+	}
+
 	slog.Info("campaign created",
 		slog.String("campaign_id", campaign.ID),
 		slog.String("slug", campaign.Slug),