added collections

app/lib/domain/models/card.dart

@@ -117,6 +117,75 @@ class ActionItems {
       {'followed': followed, 'items': items.map((e) => e.toJson()).toList()};
 }
 
+/// Deep-analysis layer (docs/14). Present only on idea-rich cards; `null` for a
+/// simple reel. Everything here is actionable: rabbit-hole threads tap into chat,
+/// the topic map orients, the research prompt is paste-ready. Each sub-section is
+/// independently optional — the UI renders only the parts that carry content.
+class Insight {
+  const Insight({
+    this.rabbitHole = const RabbitHole(),
+    this.topicMap,
+    this.deepResearchPrompt,
+  });
+
+  final RabbitHole rabbitHole;
+  final TopicMap? topicMap;
+  final String? deepResearchPrompt;
+
+  bool get hasDeepResearch =>
+      deepResearchPrompt != null && deepResearchPrompt!.trim().isNotEmpty;
+  bool get hasContent => !rabbitHole.isEmpty || topicMap != null || hasDeepResearch;
+
+  factory Insight.fromJson(Map<String, dynamic> json) => Insight(
+        rabbitHole: RabbitHole.fromJson(
+          (json['rabbit_hole'] as Map<String, dynamic>?) ?? const {},
+        ),
+        topicMap: json['topic_map'] is Map<String, dynamic>
+            ? TopicMap.fromJson(json['topic_map'] as Map<String, dynamic>)
+            : null,
+        deepResearchPrompt: json['deep_research_prompt'] as String?,
+      );
+}
+
+class RabbitHole {
+  const RabbitHole({
+    this.questions = const [],
+    this.adjacentTopics = const [],
+    this.advancedConcepts = const [],
+  });
+
+  final List<String> questions;
+  final List<String> adjacentTopics;
+  final List<String> advancedConcepts;
+
+  bool get isEmpty =>
+      questions.isEmpty && adjacentTopics.isEmpty && advancedConcepts.isEmpty;
+
+  factory RabbitHole.fromJson(Map<String, dynamic> json) {
+    List<String> l(String k) =>
+        ((json[k] as List?) ?? const []).map((e) => e.toString()).toList();
+    return RabbitHole(
+      questions: l('questions'),
+      adjacentTopics: l('adjacent_topics'),
+      advancedConcepts: l('advanced_concepts'),
+    );
+  }
+}
+
+class TopicMap {
+  const TopicMap({required this.center, this.nodes = const []});
+
+  final String center;
+  final List<String> nodes;
+
+  factory TopicMap.fromJson(Map<String, dynamic> json) => TopicMap(
+        center: (json['center'] as String?) ?? '',
+        nodes: ((json['nodes'] as List?) ?? const [])
+            .map((e) => e.toString())
+            .toList(),
+      );
+}
+
 class Media {
   const Media({this.thumbnail, this.keyframes = const []});
 
@@ -175,6 +244,7 @@ class Card {
     this.primaryAction = const PrimaryAction(),
     this.actionItems = const ActionItems(),
     this.blocks = const [],
+    this.insight,
     this.media = const Media(),
     this.meta = const Meta(),
     this.rawBlocks = const [],
@@ -189,6 +259,7 @@ class Card {
   final PrimaryAction primaryAction;
   final ActionItems actionItems;
   final List<Block> blocks;
+  final Insight? insight; // deep-analysis layer (docs/14); null for simple cards
   final Media media;
   final Meta meta;
 
@@ -224,6 +295,9 @@ class Card {
         (json['action_items'] as Map<String, dynamic>?) ?? const {},
       ),
       blocks: rawBlocks.map(Block.fromJson).toList(),
+      insight: json['insight'] is Map<String, dynamic>
+          ? Insight.fromJson(json['insight'] as Map<String, dynamic>)
+          : null,
       media: Media.fromJson((json['media'] as Map<String, dynamic>?) ?? const {}),
       meta: Meta.fromJson((json['meta'] as Map<String, dynamic>?) ?? const {}),
       rawBlocks: rawBlocks,
@@ -246,6 +320,7 @@ class Card {
         primaryAction: primaryAction,
         actionItems: actionItems ?? this.actionItems,
         blocks: blocks ?? this.blocks,
+        insight: insight,
         media: media,
         meta: meta,
         rawBlocks: rawBlocks ?? this.rawBlocks,

app/lib/domain/models/pipeline_event.dart

@@ -10,6 +10,7 @@ enum PipelineStage {
   extracting,
   structuring,
   persisting,
+  analyzing,
   done,
   failed,
   unknown;
@@ -26,6 +27,8 @@ enum PipelineStage {
         return PipelineStage.structuring;
       case 'persisting':
         return PipelineStage.persisting;
+      case 'analyzing':
+        return PipelineStage.analyzing;
       case 'done':
         return PipelineStage.done;
       case 'failed':
@@ -48,6 +51,8 @@ enum PipelineStage {
         return 'Structuring';
       case PipelineStage.persisting:
         return 'Finishing';
+      case PipelineStage.analyzing:
+        return 'Analyzing';
       case PipelineStage.done:
         return 'Ready';
       case PipelineStage.failed:
@@ -57,6 +62,31 @@ enum PipelineStage {
     }
   }
 
+  /// A fixed one-line subtitle describing what each step does — shown beneath the
+  /// label so the pipeline reads as a narrated sequence, not bare keywords.
+  String get description {
+    switch (this) {
+      case PipelineStage.snapshot:
+        return 'Getting ready';
+      case PipelineStage.downloading:
+        return 'Fetching the video source';
+      case PipelineStage.extracting:
+        return 'Transcript + on-screen text';
+      case PipelineStage.structuring:
+        return 'Building your knowledge card';
+      case PipelineStage.persisting:
+        return 'Saving to your library';
+      case PipelineStage.analyzing:
+        return 'Surfacing deeper insight';
+      case PipelineStage.done:
+        return 'Card ready';
+      case PipelineStage.failed:
+        return 'Something went wrong';
+      case PipelineStage.unknown:
+        return '';
+    }
+  }
+
   /// Ordered pipeline steps shown as a progress track (excludes terminal/meta).
   static const List<PipelineStage> track = [
     PipelineStage.downloading,

app/lib/main.dart

@@ -5,6 +5,7 @@ library;
 
 import 'dart:async';
 
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_native_splash/flutter_native_splash.dart';
 import 'package:provider/provider.dart';
@@ -56,6 +57,7 @@ class _CachyAppState extends State<CachyApp> {
   /// arrive while the app is already running. Degrades silently if the platform
   /// channel is unavailable (e.g. desktop/test).
   void _wireShareIntent() {
+    if (kIsWeb) return;
     try {
       final instance = ReceiveSharingIntent.instance;
       instance.getInitialMedia().then((files) {

app/lib/ui/core/widgets/pipeline_progress.dart

@@ -33,23 +33,40 @@ class PipelineProgress extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
     final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
     final idx = _currentIndex;
+    final total = PipelineStage.track.length;
+    // Fraction complete: finished steps + a half-credit for the active one.
+    final progress = idx < 0
+        ? 0.04
+        : ((idx.clamp(0, total) + (idx < total ? 0.5 : 0.0)) / total).clamp(0.0, 1.0);
     return Column(
       crossAxisAlignment: CrossAxisAlignment.start,
       children: [
-        for (var i = 0; i < PipelineStage.track.length; i++)
+        for (var i = 0; i < total; i++)
           _StageRow(
             label: PipelineStage.track[i].label,
+            description: PipelineStage.track[i].description,
             done: i < idx,
             active: i == idx,
             detail: i == idx ? detail : '',
-            isLast: i == PipelineStage.track.length - 1,
+            isLast: i == total - 1,
           ),
-        if (detail.isNotEmpty && idx < 0)
-          Padding(
-            padding: const EdgeInsets.only(top: 8, left: 40),
-            child: Text(detail, style: theme.textTheme.bodySmall),
+        const SizedBox(height: 4),
+        ClipRRect(
+          borderRadius: BorderRadius.circular(2),
+          child: LinearProgressIndicator(
+            value: progress,
+            minHeight: 4,
+            backgroundColor: scheme.surfaceContainerHighest,
+            valueColor: AlwaysStoppedAnimation(scheme.primary),
           ),
+        ),
+        const SizedBox(height: 8),
+        Text(
+          '${(progress * 100).round()}% complete',
+          style: theme.textTheme.bodySmall?.copyWith(color: scheme.onSurfaceVariant),
+        ),
       ],
     );
   }
@@ -58,6 +75,7 @@ class PipelineProgress extends StatelessWidget {
 class _StageRow extends StatelessWidget {
   const _StageRow({
     required this.label,
+    required this.description,
     required this.done,
     required this.active,
     required this.detail,
@@ -65,6 +83,7 @@ class _StageRow extends StatelessWidget {
   });
 
   final String label;
+  final String description;
   final bool done;
   final bool active;
   final String detail;
@@ -109,12 +128,20 @@ class _StageRow extends StatelessWidget {
                       color: lit ? scheme.onSurface : scheme.onSurfaceVariant,
                     ),
                   ),
-                  if (active && detail.isNotEmpty)
+                  // Active step shows the live SSE detail; other steps show the
+                  // fixed subtitle so the whole sequence reads as narrated work.
+                  if ((active ? (detail.isNotEmpty ? detail : description) : description)
+                      .isNotEmpty)
                     Padding(
                       padding: const EdgeInsets.only(top: 2),
-                      child: Text(detail,
-                          style: theme.textTheme.bodySmall
-                              ?.copyWith(color: scheme.onSurfaceVariant)),
+                      child: Text(
+                        active ? (detail.isNotEmpty ? detail : description) : description,
+                        style: theme.textTheme.bodySmall?.copyWith(
+                          color: lit
+                              ? scheme.onSurfaceVariant
+                              : scheme.onSurfaceVariant.withValues(alpha: 0.6),
+                        ),
+                      ),
                     ),
                 ],
               ),

app/lib/ui/core/widgets/processing_glyph.dart

@@ -0,0 +1,101 @@
+/// The signature "working" mark (docs/06): a center badge carrying a spark glyph,
+/// haloed by concentric rings that ripple outward — the calm pulse shown while a
+/// reel is processed. Adapted from the Insightr prototype's star/processing motif,
+/// reskinned into the cream/ink world (brand primary, flat — no neon glow).
+library;
+
+import 'package:flutter/material.dart';
+
+import '../brand.dart';
+
+class ProcessingGlyph extends StatefulWidget {
+  const ProcessingGlyph({
+    super.key,
+    this.size = 132,
+    this.icon = Icons.auto_awesome_rounded,
+  });
+
+  final double size;
+  final IconData icon;
+
+  @override
+  State<ProcessingGlyph> createState() => _ProcessingGlyphState();
+}
+
+class _ProcessingGlyphState extends State<ProcessingGlyph>
+    with SingleTickerProviderStateMixin {
+  late final AnimationController _c = AnimationController(
+    vsync: this,
+    duration: const Duration(milliseconds: 2400),
+  )..repeat();
+
+  static const _ringCount = 3;
+
+  @override
+  void dispose() {
+    _c.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final scheme = Theme.of(context).colorScheme;
+    final badge = widget.size * 0.42;
+    return SizedBox(
+      width: widget.size,
+      height: widget.size,
+      child: AnimatedBuilder(
+        animation: _c,
+        builder: (context, child) {
+          return Stack(
+            alignment: Alignment.center,
+            children: [
+              // Rippling halo rings, each offset in phase so they radiate steadily.
+              for (var i = 0; i < _ringCount; i++)
+                _ring(scheme, (_c.value + i / _ringCount) % 1.0, badge),
+              child!,
+            ],
+          );
+        },
+        // Center badge: a rounded square that breathes gently.
+        child: TweenAnimationBuilder<double>(
+          tween: Tween(begin: 0.0, end: 1.0),
+          duration: const Duration(milliseconds: 600),
+          curve: Curves.easeOutBack,
+          builder: (context, t, _) {
+            final pulse = 1.0 + 0.04 * (1 - (2 * (_c.value) - 1).abs());
+            return Transform.scale(
+              scale: t * pulse,
+              child: Container(
+                width: badge,
+                height: badge,
+                decoration: BoxDecoration(
+                  color: scheme.primary,
+                  borderRadius: BorderRadius.circular(badge * 0.3),
+                  boxShadow: Brand.softShadow(opacity: 0.22, blur: 22, y: 6),
+                ),
+                child: Icon(widget.icon, size: badge * 0.5, color: scheme.onPrimary),
+              ),
+            );
+          },
+        ),
+      ),
+    );
+  }
+
+  Widget _ring(ColorScheme scheme, double t, double base) {
+    final diameter = base * (1.0 + t * 1.4);
+    final opacity = (1.0 - t) * 0.35;
+    return Container(
+      width: diameter,
+      height: diameter,
+      decoration: BoxDecoration(
+        shape: BoxShape.circle,
+        border: Border.all(
+          color: scheme.primary.withValues(alpha: opacity),
+          width: 1.4,
+        ),
+      ),
+    );
+  }
+}

app/lib/ui/core/widgets/stat_strip.dart

@@ -0,0 +1,82 @@
+/// A compact dashboard strip: a row of boxed value/label cells. Used for vault
+/// stats (Profile, Catalog) and the insight stat trio atop deep cards. Editorial,
+/// flat — bordered cells on the surface, no glow.
+library;
+
+import 'package:flutter/material.dart';
+
+import '../brand.dart';
+import '../theme.dart';
+
+class Stat {
+  const Stat({required this.value, required this.label, this.emphasize = false});
+  final String value;
+  final String label;
+
+  /// Tint the value in the brand accent (used for the headline stat).
+  final bool emphasize;
+}
+
+class StatStrip extends StatelessWidget {
+  const StatStrip({super.key, required this.stats});
+  final List<Stat> stats;
+
+  @override
+  Widget build(BuildContext context) {
+    if (stats.isEmpty) return const SizedBox.shrink();
+    return IntrinsicHeight(
+      child: Row(
+        crossAxisAlignment: CrossAxisAlignment.stretch,
+        children: [
+          for (var i = 0; i < stats.length; i++) ...[
+            if (i > 0) const SizedBox(width: 10),
+            Expanded(child: _Cell(stat: stats[i])),
+          ],
+        ],
+      ),
+    );
+  }
+}
+
+class _Cell extends StatelessWidget {
+  const _Cell({required this.stat});
+  final Stat stat;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
+    return Container(
+      padding: const EdgeInsets.symmetric(horizontal: 10, vertical: 14),
+      decoration: BoxDecoration(
+        color: scheme.surfaceContainerLow,
+        borderRadius: BorderRadius.circular(Insets.radius),
+        border: Border.all(color: scheme.outlineVariant),
+      ),
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          Text(
+            stat.value,
+            maxLines: 1,
+            overflow: TextOverflow.ellipsis,
+            style: theme.textTheme.headlineSmall?.copyWith(
+              fontWeight: FontWeight.w800,
+              color: stat.emphasize ? scheme.primary : scheme.onSurface,
+            ),
+          ),
+          const SizedBox(height: 4),
+          Text(
+            stat.label.toUpperCase(),
+            textAlign: TextAlign.center,
+            style: Brand.label(
+              size: 9.5,
+              color: scheme.onSurfaceVariant,
+              weight: FontWeight.w700,
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}

app/lib/ui/features/capture/views/capture_sheet.dart

@@ -105,6 +105,18 @@ class _CaptureSheetState extends State<_CaptureSheet> {
               'Paste a link, or share to Cachy from Instagram, TikTok or YouTube.',
               style: theme.textTheme.bodyMedium?.copyWith(color: scheme.onSurfaceVariant),
             ),
+            const SizedBox(height: 16),
+
+            // Supported-platform affordance — sets expectations at a glance.
+            const Row(
+              children: [
+                _PlatformChip(label: 'Instagram', dot: Color(0xFFE1306C)),
+                SizedBox(width: 8),
+                _PlatformChip(label: 'TikTok', dot: Color(0xFF22C3D6)),
+                SizedBox(width: 8),
+                _PlatformChip(label: 'YouTube', dot: Color(0xFFE0301E)),
+              ],
+            ),
             const SizedBox(height: 20),
 
             // One-tap capture of a URL already on the clipboard.
@@ -143,6 +155,41 @@ class _CaptureSheetState extends State<_CaptureSheet> {
   }
 }
 
+/// A small static chip naming a supported source platform (colored dot + label).
+class _PlatformChip extends StatelessWidget {
+  const _PlatformChip({required this.label, required this.dot});
+  final String label;
+  final Color dot;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
+    return Container(
+      padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 7),
+      decoration: BoxDecoration(
+        color: scheme.surfaceContainerHigh,
+        borderRadius: BorderRadius.circular(999),
+        border: Border.all(color: scheme.outlineVariant),
+      ),
+      child: Row(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          Container(
+            width: 7,
+            height: 7,
+            decoration: BoxDecoration(color: dot, shape: BoxShape.circle),
+          ),
+          const SizedBox(width: 7),
+          Text(label,
+              style: theme.textTheme.labelMedium
+                  ?.copyWith(fontWeight: FontWeight.w600)),
+        ],
+      ),
+    );
+  }
+}
+
 class _ClipboardChip extends StatelessWidget {
   const _ClipboardChip({required this.url, required this.onTap});
   final String url;

app/lib/ui/features/catalog/view_models/catalog_view_model.dart

@@ -33,6 +33,12 @@ class CatalogViewModel extends ChangeNotifier {
   String? _error;
   String? get error => _error;
 
+  /// Dashboard counts over the WHOLE catalog (ignore the active filter).
+  int get entryCount => _entries.length;
+  int get typeCount => {for (final e in _entries) e.type}.length;
+  int get referencedCardCount =>
+      {for (final e in _entries) ...e.sourceCardIds}.length;
+
   /// The type filters that actually have entries, in catalog order — so the
   /// filter bar never offers an empty category.
   List<ArtifactType> get availableTypes {

app/lib/ui/features/catalog/views/catalog_detail_screen.dart

@@ -10,7 +10,10 @@ import 'package:provider/provider.dart';
 
 import '../../../../data/repositories/card_repository.dart';
 import '../../../../domain/models/artifact.dart';
+import '../../../../domain/models/card.dart' as model;
+import '../../../core/brand.dart';
 import '../../../core/theme.dart';
+import '../../reader/views/reader_screen.dart';
 import '../services/artifact_lookup.dart';
 
 class CatalogDetailScreen extends StatefulWidget {
@@ -25,6 +28,50 @@ class _CatalogDetailScreenState extends State<CatalogDetailScreen> {
   late CatalogEntry _entry = widget.entry;
   bool _loading = false;
 
+  // Backlink browsing (best-effort, async): the cards that reference this thing,
+  // and other catalog entries that co-occur in those same cards.
+  List<({String id, String title})> _appearsIn = const [];
+  List<CatalogEntry> _related = const [];
+
+  @override
+  void initState() {
+    super.initState();
+    _loadBacklinks();
+  }
+
+  Future<void> _loadBacklinks() async {
+    final repo = context.read<CardRepository>();
+    final ids = _entry.sourceCardIds;
+    // "Appears in": resolve source cards to titles (cap to keep it light).
+    final cards = await Future.wait(
+      ids.take(12).map(
+            (id) => repo.getCard(id).then<model.Card?>((c) => c).catchError((_) => null),
+          ),
+    );
+    final appears = <({String id, String title})>[];
+    for (final c in cards) {
+      if (c == null) continue;
+      final title = c.base.oneLiner.isNotEmpty ? c.base.oneLiner : 'Untitled card';
+      appears.add((id: c.cardId, title: title));
+    }
+    // "Related": catalog entries sharing at least one source card with this one.
+    var related = const <CatalogEntry>[];
+    try {
+      final all = await repo.catalog();
+      final mine = _entry.sourceCardIds.toSet();
+      related = all
+          .where((e) => e.id != _entry.id && e.sourceCardIds.any(mine.contains))
+          .take(12)
+          .toList();
+    } catch (_) {/* related is optional */}
+    if (mounted) {
+      setState(() {
+        _appearsIn = appears;
+        _related = related;
+      });
+    }
+  }
+
   Future<void> _fetchInfo() async {
     setState(() => _loading = true);
     final messenger = ScaffoldMessenger.of(context);
@@ -169,10 +216,130 @@ class _CatalogDetailScreenState extends State<CatalogDetailScreen> {
             icon: const Icon(Icons.open_in_new_rounded, size: 18),
             label: const Text('Search the web'),
           ),
+
+          if (_appearsIn.isNotEmpty) ...[
+            const SizedBox(height: 28),
+            _label(theme, 'Appears in'),
+            const SizedBox(height: 8),
+            for (final c in _appearsIn)
+              _AppearsRow(
+                title: c.title,
+                onTap: () => Navigator.of(context).push(
+                  MaterialPageRoute(builder: (_) => ReaderScreen(cardId: c.id)),
+                ),
+              ),
+          ],
+
+          if (_related.isNotEmpty) ...[
+            const SizedBox(height: 28),
+            _label(theme, 'Related'),
+            const SizedBox(height: 12),
+            Wrap(
+              spacing: 8,
+              runSpacing: 8,
+              children: [
+                for (final e in _related)
+                  _RelatedChip(
+                    entry: e,
+                    onTap: () => Navigator.of(context).push(
+                      MaterialPageRoute(builder: (_) => CatalogDetailScreen(entry: e)),
+                    ),
+                  ),
+              ],
+            ),
+          ],
         ],
       ),
     );
   }
+
+  Widget _label(ThemeData theme, String text) => Text(
+        text.toUpperCase(),
+        style: Brand.label(
+          size: 11,
+          color: theme.colorScheme.onSurfaceVariant,
+          weight: FontWeight.w700,
+          letterSpacing: 1.2,
+        ),
+      );
+}
+
+class _AppearsRow extends StatelessWidget {
+  const _AppearsRow({required this.title, required this.onTap});
+  final String title;
+  final VoidCallback onTap;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
+    return Padding(
+      padding: const EdgeInsets.only(bottom: 8),
+      child: Material(
+        color: scheme.surfaceContainerLow,
+        borderRadius: BorderRadius.circular(12),
+        child: InkWell(
+          onTap: onTap,
+          borderRadius: BorderRadius.circular(12),
+          child: Padding(
+            padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 12),
+            child: Row(
+              children: [
+                Icon(Icons.description_outlined, size: 18, color: scheme.primary),
+                const SizedBox(width: 12),
+                Expanded(
+                  child: Text(title,
+                      maxLines: 1,
+                      overflow: TextOverflow.ellipsis,
+                      style: theme.textTheme.bodyMedium),
+                ),
+                Icon(Icons.chevron_right_rounded,
+                    size: 18, color: scheme.onSurfaceVariant),
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _RelatedChip extends StatelessWidget {
+  const _RelatedChip({required this.entry, required this.onTap});
+  final CatalogEntry entry;
+  final VoidCallback onTap;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
+    return GestureDetector(
+      onTap: onTap,
+      child: Container(
+        padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
+        decoration: BoxDecoration(
+          color: scheme.surfaceContainerLow,
+          borderRadius: BorderRadius.circular(999),
+          border: Border.all(color: scheme.outlineVariant),
+        ),
+        child: Row(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Text(entry.type.sectionLabel,
+                style: Brand.label(size: 9, color: scheme.primary, weight: FontWeight.w700)),
+            const SizedBox(width: 8),
+            ConstrainedBox(
+              constraints: const BoxConstraints(maxWidth: 160),
+              child: Text(entry.title,
+                  maxLines: 1,
+                  overflow: TextOverflow.ellipsis,
+                  style: theme.textTheme.bodyMedium),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
 }
 
 /// Cover with a typed placeholder fallback (mirrors the catalog grid tile).

app/lib/ui/features/catalog/views/catalog_screen.dart

@@ -11,6 +11,7 @@ import '../../../../data/repositories/card_repository.dart';
 import '../../../../domain/models/artifact.dart';
 import '../../../core/brand.dart';
 import '../../../core/theme.dart';
+import '../../../core/widgets/stat_strip.dart';
 import '../view_models/catalog_view_model.dart';
 import 'catalog_detail_screen.dart';
 
@@ -77,10 +78,19 @@ class _CatalogView extends StatelessWidget {
       case CatalogStatus.ready:
         final sections = vm.sections;
         return ListView.builder(
-          padding: const EdgeInsets.fromLTRB(Insets.page, 8, Insets.page, 96),
+          padding: const EdgeInsets.fromLTRB(Insets.page, 12, Insets.page, 96),
           physics: const AlwaysScrollableScrollPhysics(),
-          itemCount: sections.length,
-          itemBuilder: (ctx, i) => _Section(section: sections[i], vm: vm),
+          itemCount: sections.length + 1,
+          itemBuilder: (ctx, i) {
+            if (i == 0) {
+              return StatStrip(stats: [
+                Stat(value: '${vm.entryCount}', label: 'Entries', emphasize: true),
+                Stat(value: '${vm.typeCount}', label: 'Types'),
+                Stat(value: '${vm.referencedCardCount}', label: 'From cards'),
+              ]);
+            }
+            return _Section(section: sections[i - 1], vm: vm);
+          },
         );
     }
   }

app/lib/ui/features/graph/views/graph_screen.dart

@@ -40,7 +40,7 @@ class _PhysicsConfig {
   _PhysicsConfig({
     this.repelForce = 2.2,
     this.linkForce = 1.3,
-    this.centerForce = 0.02,
+    this.centerForce = 0.005,
     this.linkDistance = 90,
   });
 }
@@ -71,13 +71,18 @@ class _GraphScreenState extends State<GraphScreen>
   final Map<String, Offset> _vel = {};
   final Map<String, List<String>> _adj = {};
   final Map<String, double> _edgeWeights = {};
+
+  // Star layout anchors — the ideal position each node should occupy.
+  final Map<String, Offset> _starPos = {};
+  static const double _starRadius = 110.0;
+  // Loose strength so the spring-back feels natural, not snappy.
+  static const double _starRestoreStrength = 0.04;
   double _temperature = 0;
 
   // View transform.
   Offset _pan = Offset.zero;
-  double _zoom = 1.0;
-  Offset _panStart = Offset.zero;
-  double _baseZoom = 1.0;
+  double _zoom = 0.72;
+  double _baseZoom = 0.72;
   String? _selected;
   String? _draggedNode;
 
@@ -125,7 +130,7 @@ class _GraphScreenState extends State<GraphScreen>
   }
 
   // --------------------------------------------------------------------------
-  // Layout seeding — random ring + jitter, then start the physics ticker
+  // Layout seeding — places nodes directly into star positions
   // --------------------------------------------------------------------------
 
   void _seedLayout(GraphData data) {
@@ -133,20 +138,13 @@ class _GraphScreenState extends State<GraphScreen>
     _vel.clear();
     _adj.clear();
     _edgeWeights.clear();
+    _starPos.clear();
 
-    final rng = math.Random(7);
-    final n = data.nodes.length;
-
-    for (var i = 0; i < n; i++) {
-      final a = (i / math.max(1, n)) * 2 * math.pi;
-      final r = 35 + rng.nextDouble() * 90;
-      _pos[data.nodes[i].id] =
-          Offset(math.cos(a) * r, math.sin(a) * r) +
-          Offset(rng.nextDouble() * 8 - 4, rng.nextDouble() * 8 - 4);
-      _vel[data.nodes[i].id] = Offset.zero;
-      _adj[data.nodes[i].id] = [];
+    // Initialise adjacency lists and zero velocities.
+    for (final node in data.nodes) {
+      _adj[node.id] = [];
+      _vel[node.id] = Offset.zero;
     }
-
     for (final e in data.edges) {
       _adj[e.source]?.add(e.target);
       _adj[e.target]?.add(e.source);
@@ -156,8 +154,107 @@ class _GraphScreenState extends State<GraphScreen>
       _edgeWeights[key] = e.weight;
     }
 
-    _temperature = 90;
-    if (!_ticker.isActive && n > 0) _ticker.start();
+    // Compute star positions and seed nodes directly into them so the graph
+    // opens already in star form — no physics convergence needed.
+    _starPos.addAll(_computeStarLayout(data, data.nodes));
+    for (final node in data.nodes) {
+      _pos[node.id] = _starPos[node.id] ?? Offset.zero;
+    }
+
+    _temperature = 45;
+    if (!_ticker.isActive && data.nodes.isNotEmpty) _ticker.start();
+  }
+
+  // --------------------------------------------------------------------------
+  // Star layout computation
+  // --------------------------------------------------------------------------
+
+  /// Returns the ideal star position for each node in [visible].
+  ///
+  /// Each connected cluster gets one **hub** (highest-degree node) placed on a
+  /// coarse ring, with all other cluster members as **spokes** radiating
+  /// outward at equal angular intervals.
+  ///
+  /// Cluster-hub separation = `_starRadius * 2.4` so adjacent clusters' spoke
+  /// disks never spatially overlap, preventing cross-cluster edge crossings.
+  Map<String, Offset> _computeStarLayout(
+      GraphData data, List<GraphNode> visible) {
+    final result = <String, Offset>{};
+
+    // Group nodes by cluster ID.
+    final clusterMap = <int, List<GraphNode>>{};
+    for (final node in visible) {
+      clusterMap.putIfAbsent(node.clusterId, () => []).add(node);
+    }
+
+    // Isolated nodes (-1) live on an outer ring, handled separately.
+    final isolated = clusterMap.remove(-1) ?? <GraphNode>[];
+    final clusterIds = clusterMap.keys.toList()..sort();
+    final numClusters = clusterIds.length;
+
+    // Minimum separation between adjacent cluster hubs so that no spoke from
+    // cluster A can reach any spoke of cluster B.
+    const clusterSep = _starRadius * 2.4;
+    // Chord formula: for n equally spaced points on a ring, the chord between
+    // adjacent points = 2 * R * sin(π / n). Solve for R given chord = clusterSep.
+    final hubRingRadius = numClusters <= 1
+        ? 0.0
+        : clusterSep / (2 * math.sin(math.pi / numClusters));
+
+    for (var ci = 0; ci < numClusters; ci++) {
+      final cid = clusterIds[ci];
+      final nodes = List<GraphNode>.from(clusterMap[cid]!);
+
+      // Highest-degree node becomes the star's hub.
+      nodes.sort((a, b) => b.degree.compareTo(a.degree));
+      final hub = nodes.first;
+
+      final hubAngle =
+          (ci / math.max(1, numClusters)) * 2 * math.pi - math.pi / 2;
+      final hubPos = numClusters <= 1
+          ? Offset.zero
+          : Offset(
+              math.cos(hubAngle) * hubRingRadius,
+              math.sin(hubAngle) * hubRingRadius,
+            );
+      result[hub.id] = hubPos;
+
+      // Place spoke nodes at equal angular intervals around the hub.
+      final spokes = nodes.skip(1).toList();
+      for (var si = 0; si < spokes.length; si++) {
+        final spokeAngle =
+            (si / math.max(1, spokes.length)) * 2 * math.pi - math.pi / 2;
+        result[spokes[si].id] = hubPos +
+            Offset(
+              math.cos(spokeAngle) * _starRadius,
+              math.sin(spokeAngle) * _starRadius,
+            );
+      }
+    }
+
+    // Isolated nodes on a ring well beyond all star clusters.
+    final outerRadius = hubRingRadius + _starRadius * 1.6;
+    for (var ii = 0; ii < isolated.length; ii++) {
+      final angle =
+          (ii / math.max(1, isolated.length)) * 2 * math.pi - math.pi / 2;
+      result[isolated[ii].id] = Offset(
+        math.cos(angle) * outerRadius,
+        math.sin(angle) * outerRadius,
+      );
+    }
+
+    return result;
+  }
+
+  /// Recomputes star target positions for the currently visible node set and
+  /// updates [_starPos].  Call whenever local-mode or depth changes.
+  void _recomputeStar() {
+    final data = _data;
+    if (data == null) return;
+    final visible = _visibleNodes(data);
+    _starPos
+      ..clear()
+      ..addAll(_computeStarLayout(data, visible));
   }
 
   // --------------------------------------------------------------------------
@@ -263,6 +360,18 @@ class _GraphScreenState extends State<GraphScreen>
       disp[id] = disp[id]! - p * _physics.centerForce;
     }
 
+    // --- Force 4: Star restoring spring ---
+    // Pulls every non-dragged node gently back to its ideal star position.
+    // Strength 0.04 = loose and natural; large enough to correct drift over
+    // a few seconds, small enough not to fight the user's drag.
+    for (final id in ids) {
+      if (id == _draggedNode) continue;
+      final target = _starPos[id];
+      final current = _pos[id];
+      if (target == null || current == null) continue;
+      disp[id] = disp[id]! + (target - current) * _starRestoreStrength;
+    }
+
     // --- Apply forces with temperature clamping + velocity damping ---
     const damping = 0.80; // less drag = bouncier spring oscillation
     for (final node in visible) {
@@ -313,7 +422,6 @@ class _GraphScreenState extends State<GraphScreen>
 
   void _onScaleStart(ScaleStartDetails d, Size size) {
     _baseZoom = _zoom;
-    _panStart = _pan;
     final hit = _hitTest(d.localFocalPoint, size);
     if (hit != null && d.pointerCount == 1) {
       _draggedNode = hit;
@@ -350,7 +458,9 @@ class _GraphScreenState extends State<GraphScreen>
 
   void _onScaleEnd(ScaleEndDetails d) {
     if (_draggedNode != null) {
-      _temperature = math.max(_temperature, 25.0);
+      // Reheat enough for the restoring force to animate the snap-back
+      // visibly, but not so hot that distant nodes thrash.
+      _temperature = math.max(_temperature, 45.0);
       if (!_ticker.isActive) _ticker.start();
     }
     _draggedNode = null;
@@ -438,10 +548,10 @@ class _GraphScreenState extends State<GraphScreen>
           setState(() {
             _localMode = true;
             _localRoot = node.id;
-            // Reheat so visible subset re-settles.
             _temperature = 60;
             if (!_ticker.isActive) _ticker.start();
           });
+          _recomputeStar();
         },
       ),
     );
@@ -475,6 +585,8 @@ class _GraphScreenState extends State<GraphScreen>
             _temperature = 60;
             if (!_ticker.isActive) _ticker.start();
           });
+          _recomputeStar();
+          // Update the bottom sheet's own state.
           (ctx as Element).markNeedsBuild();
         },
         onLocalDepthChanged: (v) {
@@ -483,6 +595,7 @@ class _GraphScreenState extends State<GraphScreen>
             _temperature = 60;
             if (!_ticker.isActive) _ticker.start();
           });
+          _recomputeStar();
           (ctx as Element).markNeedsBuild();
         },
       ),
@@ -563,12 +676,15 @@ class _GraphScreenState extends State<GraphScreen>
                     ?.label ??
                 'Unknown',
             depth: _localDepth,
-            onExit: () => setState(() {
-              _localMode = false;
-              _localRoot = null;
-              _temperature = 60;
-              if (!_ticker.isActive) _ticker.start();
-            }),
+            onExit: () {
+              setState(() {
+                _localMode = false;
+                _localRoot = null;
+                _temperature = 60;
+                if (!_ticker.isActive) _ticker.start();
+              });
+              _recomputeStar();
+            },
           ),
         // Cluster filter chips.
         if (!_localMode && data.clusters.isNotEmpty)

app/lib/ui/features/library/views/card_tile.dart

@@ -95,6 +95,7 @@ class CardTile extends StatelessWidget {
                       height: 1.15,
                     ),
                   ),
+                  if (card.isReady) _MetaPills(card: card),
                 ],
               ),
             ),
@@ -133,3 +134,68 @@ class CardTile extends StatelessWidget {
     if (ok == true) onDelete();
   }
 }
+
+/// Compact at-a-glance counts on a tile scrim — how much a card carries before
+/// you open it (actions to do, steps inside, deeper analysis). Renders nothing
+/// when the card has none.
+class _MetaPills extends StatelessWidget {
+  const _MetaPills({required this.card});
+  final model.Card card;
+
+  @override
+  Widget build(BuildContext context) {
+    final actions = card.actionItems.items.length;
+    var steps = 0;
+    for (final b in card.rawBlocks) {
+      final type = b['type'];
+      if (type == 'step_list') steps += (b['steps'] as List?)?.length ?? 0;
+      if (type == 'checklist') steps += (b['items'] as List?)?.length ?? 0;
+    }
+    final hasInsight = card.insight?.hasContent ?? false;
+
+    final pills = <String>[
+      if (actions > 0) '$actions ${actions == 1 ? 'action' : 'actions'}',
+      if (steps > 0) '$steps steps',
+    ];
+    if (pills.isEmpty && !hasInsight) return const SizedBox.shrink();
+
+    return Padding(
+      padding: const EdgeInsets.only(top: 7),
+      child: Wrap(
+        spacing: 6,
+        runSpacing: 6,
+        children: [
+          for (final p in pills) _Pill(label: p),
+          if (hasInsight) const _Pill(label: 'Deep', highlight: true),
+        ],
+      ),
+    );
+  }
+}
+
+class _Pill extends StatelessWidget {
+  const _Pill({required this.label, this.highlight = false});
+  final String label;
+  final bool highlight;
+
+  @override
+  Widget build(BuildContext context) {
+    return Container(
+      padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 3),
+      decoration: BoxDecoration(
+        color: highlight
+            ? Colors.white.withValues(alpha: 0.92)
+            : Colors.white.withValues(alpha: 0.18),
+        borderRadius: BorderRadius.circular(999),
+      ),
+      child: Text(
+        label,
+        style: Brand.label(
+          size: 9.5,
+          color: highlight ? Colors.black87 : Colors.white,
+          weight: FontWeight.w700,
+        ),
+      ),
+    );
+  }
+}

app/lib/ui/features/onboarding/views/onboarding_screen.dart

@@ -128,16 +128,7 @@ class _Panel extends StatelessWidget {
       child: Column(
         mainAxisAlignment: MainAxisAlignment.center,
         children: [
-          Container(
-            width: 132,
-            height: 132,
-            decoration: BoxDecoration(
-              color: theme.colorScheme.primary.withValues(alpha: 0.10),
-              shape: BoxShape.circle,
-              border: Border.all(color: theme.colorScheme.primary.withValues(alpha: 0.3)),
-            ),
-            child: Icon(icon, size: 58, color: theme.colorScheme.primary),
-          ),
+          _RingedIcon(icon: icon),
           const SizedBox(height: 40),
           Text(title, textAlign: TextAlign.center, style: theme.textTheme.headlineMedium),
           const SizedBox(height: 14),
@@ -152,3 +143,44 @@ class _Panel extends StatelessWidget {
     );
   }
 }
+
+/// A haloed feature icon: a filled tinted core ringed by two concentric outlines
+/// that fade outward — the onboarding's "feature highlight" motif.
+class _RingedIcon extends StatelessWidget {
+  const _RingedIcon({required this.icon});
+  final IconData icon;
+
+  @override
+  Widget build(BuildContext context) {
+    final primary = Theme.of(context).colorScheme.primary;
+    Widget ring(double size, double alpha) => Container(
+          width: size,
+          height: size,
+          decoration: BoxDecoration(
+            shape: BoxShape.circle,
+            border: Border.all(color: primary.withValues(alpha: alpha)),
+          ),
+        );
+    return SizedBox(
+      width: 168,
+      height: 168,
+      child: Stack(
+        alignment: Alignment.center,
+        children: [
+          ring(168, 0.10),
+          ring(140, 0.20),
+          Container(
+            width: 108,
+            height: 108,
+            decoration: BoxDecoration(
+              color: primary.withValues(alpha: 0.10),
+              shape: BoxShape.circle,
+              border: Border.all(color: primary.withValues(alpha: 0.35)),
+            ),
+            child: Icon(icon, size: 50, color: primary),
+          ),
+        ],
+      ),
+    );
+  }
+}

app/lib/ui/features/onboarding/views/splash_screen.dart

@@ -82,6 +82,20 @@ class _SplashScreenState extends State<SplashScreen>
                     ),
                   ),
                 ),
+                const SizedBox(height: 28),
+                // Floating capability chips drift up as the wordmark settles.
+                _FloatingChip(
+                  icon: Icons.video_library_rounded,
+                  label: 'Short-form videos',
+                  t: _wordmark.value,
+                ),
+                const SizedBox(height: 12),
+                _FloatingChip(
+                  icon: Icons.auto_awesome_rounded,
+                  label: 'AI-powered recall',
+                  // Slight stagger so the second chip trails the first.
+                  t: (_wordmark.value * 1.25 - 0.25).clamp(0.0, 1.0),
+                ),
               ],
             ),
           ),
@@ -91,6 +105,40 @@ class _SplashScreenState extends State<SplashScreen>
   }
 }
 
+/// A glassy capability pill that fades + drifts up — the splash's floating tags.
+class _FloatingChip extends StatelessWidget {
+  const _FloatingChip({required this.icon, required this.label, required this.t});
+  final IconData icon;
+  final String label;
+  final double t;
+
+  @override
+  Widget build(BuildContext context) {
+    return Opacity(
+      opacity: t.clamp(0.0, 1.0),
+      child: Transform.translate(
+        offset: Offset(0, (1 - t) * 16),
+        child: Container(
+          padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 9),
+          decoration: BoxDecoration(
+            color: Brand.creamRaised,
+            borderRadius: BorderRadius.circular(999),
+            border: Border.all(color: Brand.ink.withValues(alpha: 0.08)),
+          ),
+          child: Row(
+            mainAxisSize: MainAxisSize.min,
+            children: [
+              Icon(icon, size: 15, color: Brand.rust),
+              const SizedBox(width: 8),
+              Text(label, style: Brand.label(size: 12, color: Brand.ink, weight: FontWeight.w600)),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}
+
 /// A small loading splash variant reused while the app boots, without animation.
 class SplashStatic extends StatelessWidget {
   const SplashStatic({super.key});

app/lib/ui/features/profile/views/profile_screen.dart

@@ -7,11 +7,12 @@ import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
 
 import '../../../../data/repositories/card_repository.dart';
+import '../../../../domain/models/artifact.dart';
 import '../../../../domain/models/card.dart' as model;
-import '../../../../domain/models/enums.dart';
 import '../../../core/app_controller.dart';
 import '../../../core/brand.dart';
 import '../../../core/theme.dart';
+import '../../../core/widgets/stat_strip.dart';
 
 class ProfileScreen extends StatefulWidget {
   const ProfileScreen({super.key});
@@ -22,11 +23,14 @@ class ProfileScreen extends StatefulWidget {
 
 class _ProfileScreenState extends State<ProfileScreen> {
   late Future<List<model.Card>> _cards;
+  late Future<List<CatalogEntry>> _catalog;
 
   @override
   void initState() {
     super.initState();
-    _cards = context.read<CardRepository>().list();
+    final repo = context.read<CardRepository>();
+    _cards = repo.list();
+    _catalog = repo.catalog().catchError((_) => <CatalogEntry>[]);
   }
 
   @override
@@ -68,44 +72,40 @@ class _ProfileScreenState extends State<ProfileScreen> {
   }
 
   Widget _header(ThemeData theme) {
+    final scheme = theme.colorScheme;
     return FutureBuilder<List<model.Card>>(
       future: _cards,
       builder: (context, snap) {
         final cards = snap.data ?? const <model.Card>[];
         final total = cards.length;
-        final todo = cards
-            .where((c) => c.base.contentType == ContentType.recipe ||
-                c.base.contentType == ContentType.workout)
+        final weekAgo = DateTime.now().subtract(const Duration(days: 7));
+        final thisWeek = cards
+            .where((c) => (c.meta.createdAt ?? DateTime(0)).isAfter(weekAgo))
             .length;
-        final scheme = theme.colorScheme;
-        return Container(
-          padding: const EdgeInsets.all(22),
-          decoration: BoxDecoration(
-            color: scheme.surfaceContainerLow,
-            borderRadius: BorderRadius.circular(Insets.radius),
-            border: Border.all(color: scheme.outlineVariant),
-          ),
-          child: Row(
-            children: [
-              CachyGlyph(size: 44, color: scheme.onSurface, reelColor: scheme.primary),
-              const SizedBox(width: 16),
-              Expanded(
-                child: Column(
-                  crossAxisAlignment: CrossAxisAlignment.start,
-                  children: [
-                    Text('Your shelf',
-                        style: Brand.wordmarkStyle(24, color: scheme.onSurface)),
-                    const SizedBox(height: 6),
-                    Text(
-                      '$total ${total == 1 ? 'CARD' : 'CARDS'}'
-                      '${todo > 0 ? '  ·  $todo TO DO' : ''}',
-                      style: Brand.label(size: 11, color: scheme.onSurfaceVariant),
-                    ),
-                  ],
-                ),
-              ),
-            ],
-          ),
+        return Column(
+          crossAxisAlignment: CrossAxisAlignment.stretch,
+          children: [
+            Row(
+              children: [
+                CachyGlyph(size: 44, color: scheme.onSurface, reelColor: scheme.primary),
+                const SizedBox(width: 14),
+                Text('Your shelf',
+                    style: Brand.wordmarkStyle(24, color: scheme.onSurface)),
+              ],
+            ),
+            const SizedBox(height: 16),
+            FutureBuilder<List<CatalogEntry>>(
+              future: _catalog,
+              builder: (context, catSnap) {
+                final refs = catSnap.data?.length;
+                return StatStrip(stats: [
+                  Stat(value: '$total', label: 'Cards', emphasize: true),
+                  Stat(value: '$thisWeek', label: 'This week'),
+                  Stat(value: refs == null ? '—' : '$refs', label: 'References'),
+                ]);
+              },
+            ),
+          ],
         );
       },
     );

app/lib/ui/features/reader/view_models/chat_view_model.dart

@@ -34,6 +34,13 @@ class ChatViewModel extends ChangeNotifier {
 
   bool get isEmpty => _messages.isEmpty;
 
+  /// Fire an opening question on entry (rabbit-hole tap → grounded chat). Runs
+  /// after the first frame so the screen is already mounted when the reply lands.
+  void seed(String? text) {
+    if (text == null || text.trim().isEmpty) return;
+    Future.microtask(() => send(text));
+  }
+
   Future<void> send(String text) async {
     final trimmed = text.trim();
     if (trimmed.isEmpty || _busy) return;

app/lib/ui/features/reader/views/chat_screen.dart

@@ -12,17 +12,25 @@ import '../../../core/theme.dart';
 import '../view_models/chat_view_model.dart';
 
 class ChatScreen extends StatelessWidget {
-  const ChatScreen({super.key, required this.cardId, required this.title});
+  const ChatScreen({
+    super.key,
+    required this.cardId,
+    required this.title,
+    this.seed,
+  });
   final String cardId;
   final String title;
 
+  /// Optional opening question, auto-sent on entry (rabbit-hole → ask the card).
+  final String? seed;
+
   @override
   Widget build(BuildContext context) {
     return ChangeNotifierProvider(
       create: (ctx) => ChatViewModel(
         repository: ctx.read<CardRepository>(),
         cardId: cardId,
-      ),
+      )..seed(seed),
       child: _ChatView(title: title),
     );
   }

app/lib/ui/features/reader/views/insight_section.dart

@@ -0,0 +1,561 @@
+/// The deep-analysis layer (docs/14): claims, blind spots, rabbit holes, a small
+/// topic map, and a doorway to the deep-research prompt. Rendered ONLY when a card
+/// carries an `insight` (idea-rich content); a simple reel shows none of this. Each
+/// sub-section guards on its own content, so a partial layer renders cleanly.
+library;
+
+import 'dart:math' as math;
+
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+
+import '../../../../domain/models/card.dart';
+import '../../../core/brand.dart';
+import '../../../core/content_accent.dart';
+import '../../../core/theme.dart';
+import '../../../core/widgets/stat_strip.dart';
+import 'chat_screen.dart';
+
+class InsightSection extends StatelessWidget {
+  const InsightSection({
+    super.key,
+    required this.insight,
+    required this.accent,
+    required this.cardId,
+    required this.cardTitle,
+    required this.readMinutes,
+  });
+
+  final Insight insight;
+  final ContentAccent accent;
+  final String cardId;
+  final String cardTitle;
+
+  /// Estimated read time of the card body, computed by the reader.
+  final int readMinutes;
+
+  List<Stat> _trio() {
+    final rh = insight.rabbitHole;
+    final threads =
+        rh.questions.length + rh.adjacentTopics.length + rh.advancedConcepts.length;
+    return [
+      Stat(value: '${readMinutes < 1 ? 1 : readMinutes}m', label: 'Read'),
+      Stat(value: '$threads', label: 'Threads', emphasize: true),
+      if (insight.topicMap != null)
+        Stat(value: '${insight.topicMap!.nodes.length}', label: 'Topics'),
+    ];
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final children = <Widget>[];
+    if (!insight.rabbitHole.isEmpty) {
+      children.add(_RabbitHoleCard(
+        rabbitHole: insight.rabbitHole,
+        accent: accent,
+        cardId: cardId,
+        cardTitle: cardTitle,
+      ));
+    }
+    if (insight.topicMap != null) {
+      children.add(_TopicMapCard(map: insight.topicMap!, accent: accent));
+    }
+    if (insight.hasDeepResearch) {
+      children.add(_DeepResearchButton(prompt: insight.deepResearchPrompt!, accent: accent));
+    }
+    if (children.isEmpty) return const SizedBox.shrink();
+
+    return Padding(
+      padding: const EdgeInsets.only(top: 28),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.stretch,
+        children: [
+          _SectionHeader(icon: Icons.psychology_alt_rounded, label: 'Going deeper', accent: accent),
+          const SizedBox(height: 12),
+          StatStrip(stats: _trio()),
+          const SizedBox(height: 14),
+          _DiveDeeperButton(accent: accent, children: children),
+        ],
+      ),
+    );
+  }
+}
+
+class _DiveDeeperButton extends StatefulWidget {
+  const _DiveDeeperButton({required this.accent, required this.children});
+  final ContentAccent accent;
+  final List<Widget> children;
+
+  @override
+  State<_DiveDeeperButton> createState() => _DiveDeeperButtonState();
+}
+
+class _DiveDeeperButtonState extends State<_DiveDeeperButton> {
+  bool _expanded = false;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.stretch,
+      children: [
+        Material(
+          color: _expanded ? scheme.surfaceContainerHighest : scheme.surfaceContainerLow,
+          shape: RoundedRectangleBorder(
+            borderRadius: BorderRadius.circular(Insets.radius),
+            side: BorderSide(
+              color: _expanded ? widget.accent.color : scheme.outlineVariant,
+              width: _expanded ? 1.5 : 1.0,
+            ),
+          ),
+          clipBehavior: Clip.antiAlias,
+          child: InkWell(
+            onTap: () => setState(() => _expanded = !_expanded),
+            child: Padding(
+              padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 14),
+              child: Row(
+                children: [
+                  Icon(Icons.travel_explore_rounded, size: 20, color: widget.accent.color),
+                  const SizedBox(width: 10),
+                  Expanded(
+                    child: Text(
+                      'Dive deeper',
+                      style: theme.textTheme.titleMedium?.copyWith(fontWeight: FontWeight.w700),
+                    ),
+                  ),
+                  AnimatedRotation(
+                    turns: _expanded ? 0.5 : 0.0,
+                    duration: const Duration(milliseconds: 200),
+                    curve: Curves.easeInOut,
+                    child: Icon(Icons.expand_more_rounded, color: scheme.onSurfaceVariant),
+                  ),
+                ],
+              ),
+            ),
+          ),
+        ),
+        AnimatedCrossFade(
+          firstChild: const SizedBox.shrink(),
+          secondChild: Column(
+            crossAxisAlignment: CrossAxisAlignment.stretch,
+            children: [
+              for (final child in widget.children)
+                Padding(padding: const EdgeInsets.only(top: 12), child: child),
+            ],
+          ),
+          crossFadeState: _expanded ? CrossFadeState.showSecond : CrossFadeState.showFirst,
+          duration: const Duration(milliseconds: 250),
+          sizeCurve: Curves.easeOutCubic,
+        ),
+      ],
+    );
+  }
+}
+
+class _SectionHeader extends StatelessWidget {
+  const _SectionHeader({required this.icon, required this.label, required this.accent});
+  final IconData icon;
+  final String label;
+  final ContentAccent accent;
+
+  @override
+  Widget build(BuildContext context) {
+    return Row(
+      children: [
+        Icon(icon, size: 16, color: accent.color),
+        const SizedBox(width: 7),
+        Text(label.toUpperCase(),
+            style: Brand.label(size: 11, color: accent.color, weight: FontWeight.w700)),
+      ],
+    );
+  }
+}
+
+/// A bordered container shared by the insight cards — matches the reader's
+/// editorial surfaces.
+class _Panel extends StatelessWidget {
+  const _Panel({required this.title, required this.icon, required this.child});
+  final String title;
+  final IconData icon;
+  final Widget child;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
+    return Container(
+      padding: const EdgeInsets.all(16),
+      decoration: BoxDecoration(
+        color: scheme.surfaceContainerLow,
+        borderRadius: BorderRadius.circular(Insets.radius),
+        border: Border.all(color: scheme.outlineVariant),
+      ),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Row(
+            children: [
+              Icon(icon, size: 18, color: scheme.onSurfaceVariant),
+              const SizedBox(width: 8),
+              Text(title,
+                  style: theme.textTheme.titleMedium?.copyWith(fontWeight: FontWeight.w700)),
+            ],
+          ),
+          const SizedBox(height: 12),
+          child,
+        ],
+      ),
+    );
+  }
+}
+
+// --- Rabbit hole ----------------------------------------------------------- //
+
+class _RabbitHoleCard extends StatelessWidget {
+  const _RabbitHoleCard({
+    required this.rabbitHole,
+    required this.accent,
+    required this.cardId,
+    required this.cardTitle,
+  });
+  final RabbitHole rabbitHole;
+  final ContentAccent accent;
+  final String cardId;
+  final String cardTitle;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final groups = <(String, List<String>)>[
+      ('Questions', rabbitHole.questions),
+      ('Adjacent topics', rabbitHole.adjacentTopics),
+      ('Advanced concepts', rabbitHole.advancedConcepts),
+    ].where((g) => g.$2.isNotEmpty).toList();
+
+    return _Panel(
+      title: 'Rabbit hole',
+      icon: Icons.travel_explore_rounded,
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Padding(
+            padding: const EdgeInsets.only(bottom: 6),
+            child: Text('Tap a thread to go deeper — the card answers, grounded in its content.',
+                style: theme.textTheme.bodySmall
+                    ?.copyWith(color: theme.colorScheme.onSurfaceVariant)),
+          ),
+          for (final group in groups)
+            _RabbitHoleGroup(
+              label: group.$1,
+              items: group.$2,
+              accent: accent,
+              cardId: cardId,
+              cardTitle: cardTitle,
+            ),
+        ],
+      ),
+    );
+  }
+}
+
+class _RabbitHoleGroup extends StatelessWidget {
+  const _RabbitHoleGroup({
+    required this.label,
+    required this.items,
+    required this.accent,
+    required this.cardId,
+    required this.cardTitle,
+  });
+  final String label;
+  final List<String> items;
+  final ContentAccent accent;
+  final String cardId;
+  final String cardTitle;
+
+  void _ask(BuildContext context, String thread) {
+    Navigator.of(context).push(
+      MaterialPageRoute(
+        builder: (_) => ChatScreen(cardId: cardId, title: cardTitle, seed: thread),
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    return Theme(
+      data: theme.copyWith(dividerColor: Colors.transparent),
+      child: ExpansionTile(
+        tilePadding: EdgeInsets.zero,
+        childrenPadding: const EdgeInsets.only(bottom: 4),
+        expandedCrossAxisAlignment: CrossAxisAlignment.start,
+        initiallyExpanded: true,
+        title: Text(label,
+            style: theme.textTheme.bodyMedium?.copyWith(fontWeight: FontWeight.w600)),
+        trailing: Container(
+          padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 2),
+          decoration: BoxDecoration(
+            color: theme.colorScheme.surfaceContainerHighest,
+            borderRadius: BorderRadius.circular(999),
+          ),
+          child: Text('${items.length}',
+              style: theme.textTheme.labelSmall
+                  ?.copyWith(color: theme.colorScheme.onSurfaceVariant)),
+        ),
+        children: [
+          for (final item in items)
+            InkWell(
+              onTap: () => _ask(context, item),
+              borderRadius: BorderRadius.circular(8),
+              child: Padding(
+                padding: const EdgeInsets.symmetric(vertical: 8),
+                child: Row(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    Padding(
+                      padding: const EdgeInsets.only(top: 1),
+                      child: Icon(Icons.chat_bubble_outline_rounded,
+                          size: 15, color: accent.color),
+                    ),
+                    const SizedBox(width: 8),
+                    Expanded(
+                      child: Text(item,
+                          style: theme.textTheme.bodyMedium?.copyWith(height: 1.3)),
+                    ),
+                    Icon(Icons.arrow_outward_rounded,
+                        size: 14, color: theme.colorScheme.onSurfaceVariant),
+                  ],
+                ),
+              ),
+            ),
+        ],
+      ),
+    );
+  }
+}
+
+// --- Topic map ------------------------------------------------------------- //
+
+class _TopicMapCard extends StatelessWidget {
+  const _TopicMapCard({required this.map, required this.accent});
+  final TopicMap map;
+  final ContentAccent accent;
+
+  @override
+  Widget build(BuildContext context) {
+    return _Panel(
+      title: 'Topic map',
+      icon: Icons.hub_outlined,
+      child: SizedBox(
+        height: 240,
+        width: double.infinity,
+        child: CustomPaint(
+          painter: _TopicMapPainter(
+            center: map.center,
+            nodes: map.nodes,
+            accent: accent.color,
+            line: Theme.of(context).colorScheme.outlineVariant,
+            centerText: Colors.white,
+            nodeFill: Theme.of(context).colorScheme.surfaceContainerHighest,
+            nodeText: Theme.of(context).colorScheme.onSurface,
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _TopicMapPainter extends CustomPainter {
+  _TopicMapPainter({
+    required this.center,
+    required this.nodes,
+    required this.accent,
+    required this.line,
+    required this.centerText,
+    required this.nodeFill,
+    required this.nodeText,
+  });
+
+  final String center;
+  final List<String> nodes;
+  final Color accent;
+  final Color line;
+  final Color centerText;
+  final Color nodeFill;
+  final Color nodeText;
+
+  @override
+  void paint(Canvas canvas, Size size) {
+    final c = Offset(size.width / 2, size.height / 2);
+    final radius = math.min(size.width, size.height) / 2 - 38;
+    const centerR = 40.0;
+    const nodeR = 30.0;
+
+    final linePaint = Paint()
+      ..color = line
+      ..strokeWidth = 1.2
+      ..style = PaintingStyle.stroke;
+
+    final positions = <Offset>[];
+    for (var i = 0; i < nodes.length; i++) {
+      final angle = -math.pi / 2 + (2 * math.pi * i / nodes.length);
+      positions.add(Offset(c.dx + radius * math.cos(angle), c.dy + radius * math.sin(angle)));
+    }
+
+    // Connecting lines (dashed-ish: just straight, kept subtle).
+    for (final p in positions) {
+      canvas.drawLine(c, p, linePaint);
+    }
+
+    // Satellite nodes.
+    for (var i = 0; i < positions.length; i++) {
+      canvas.drawCircle(positions[i], nodeR, Paint()..color = nodeFill);
+      canvas.drawCircle(positions[i], nodeR, linePaint);
+      _label(canvas, nodes[i], positions[i], nodeR * 2 - 6, nodeText, 9);
+    }
+
+    // Center node.
+    canvas.drawCircle(c, centerR, Paint()..color = accent);
+    _label(canvas, center, c, centerR * 2 - 6, centerText, 11, bold: true);
+  }
+
+  void _label(Canvas canvas, String text, Offset at, double maxWidth, Color color,
+      double fontSize, {bool bold = false}) {
+    final tp = TextPainter(
+      text: TextSpan(
+        text: text,
+        style: TextStyle(
+          color: color,
+          fontSize: fontSize,
+          fontWeight: bold ? FontWeight.w800 : FontWeight.w600,
+          height: 1.1,
+        ),
+      ),
+      textAlign: TextAlign.center,
+      textDirection: TextDirection.ltr,
+      maxLines: 2,
+      ellipsis: '…',
+    )..layout(maxWidth: maxWidth);
+    tp.paint(canvas, Offset(at.dx - tp.width / 2, at.dy - tp.height / 2));
+  }
+
+  @override
+  bool shouldRepaint(covariant _TopicMapPainter old) =>
+      old.center != center || old.nodes != nodes || old.accent != accent;
+}
+
+// --- Deep research --------------------------------------------------------- //
+
+class _DeepResearchButton extends StatelessWidget {
+  const _DeepResearchButton({required this.prompt, required this.accent});
+  final String prompt;
+  final ContentAccent accent;
+
+  @override
+  Widget build(BuildContext context) {
+    return SizedBox(
+      width: double.infinity,
+      child: FilledButton.icon(
+        style: FilledButton.styleFrom(
+          backgroundColor: accent.color,
+          foregroundColor: Colors.white,
+          padding: const EdgeInsets.symmetric(vertical: 16),
+        ),
+        onPressed: () => Navigator.of(context).push(
+          MaterialPageRoute(builder: (_) => DeepResearchScreen(prompt: prompt, accent: accent)),
+        ),
+        icon: const Icon(Icons.auto_awesome_rounded, size: 18),
+        label: const Text('Deep research prompt'),
+      ),
+    );
+  }
+}
+
+/// The deep-research prompt screen (docs/14): a ready-to-paste research brief for
+/// an external frontier LLM. Copy is the dominant action.
+class DeepResearchScreen extends StatelessWidget {
+  const DeepResearchScreen({super.key, required this.prompt, required this.accent});
+  final String prompt;
+  final ContentAccent accent;
+
+  int get _tokenEstimate => (prompt.length / 4).ceil();
+
+  void _copy(BuildContext context) {
+    Clipboard.setData(ClipboardData(text: prompt));
+    ScaffoldMessenger.of(context).showSnackBar(
+      const SnackBar(content: Text('Prompt copied'), duration: Motion.medium),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
+    return Scaffold(
+      appBar: AppBar(title: const Text('Deep research')),
+      body: Center(
+        child: ConstrainedBox(
+          constraints: const BoxConstraints(maxWidth: Insets.readingColumn),
+          child: ListView(
+            padding: const EdgeInsets.fromLTRB(Insets.page, 16, Insets.page, 120),
+            children: [
+              Row(
+                children: [
+                  Icon(Icons.auto_awesome_rounded, size: 16, color: accent.color),
+                  const SizedBox(width: 7),
+                  Text('DEEP RESEARCH PROMPT',
+                      style: Brand.label(size: 11, color: accent.color, weight: FontWeight.w700)),
+                ],
+              ),
+              const SizedBox(height: 8),
+              Text('~$_tokenEstimate tokens · paste into ChatGPT or Gemini',
+                  style: theme.textTheme.bodySmall
+                      ?.copyWith(color: scheme.onSurfaceVariant)),
+              const SizedBox(height: 16),
+              Container(
+                padding: const EdgeInsets.all(16),
+                decoration: BoxDecoration(
+                  color: scheme.surfaceContainerLow,
+                  borderRadius: BorderRadius.circular(Insets.radius),
+                  border: Border.all(color: scheme.outlineVariant),
+                ),
+                child: SelectableText(
+                  prompt,
+                  style: theme.textTheme.bodyMedium?.copyWith(
+                    fontFamily: 'monospace',
+                    height: 1.5,
+                  ),
+                ),
+              ),
+            ],
+          ),
+        ),
+      ),
+      bottomSheet: Padding(
+        padding: const EdgeInsets.fromLTRB(Insets.page, 8, Insets.page, 20),
+        child: Row(
+          children: [
+            Expanded(
+              child: FilledButton.icon(
+                style: FilledButton.styleFrom(
+                  backgroundColor: accent.color,
+                  foregroundColor: Colors.white,
+                  padding: const EdgeInsets.symmetric(vertical: 16),
+                ),
+                onPressed: () => _copy(context),
+                icon: const Icon(Icons.copy_rounded, size: 18),
+                label: const Text('Copy prompt'),
+              ),
+            ),
+            const SizedBox(width: 12),
+            IconButton.filledTonal(
+              onPressed: () => _copy(context),
+              icon: const Icon(Icons.ios_share_rounded),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}

app/lib/ui/features/reader/views/reader_screen.dart

@@ -20,9 +20,11 @@ import '../../../core/theme.dart';
 import '../../../core/widgets/card_face.dart';
 import '../../../core/widgets/error_state.dart';
 import '../../../core/widgets/pipeline_progress.dart';
+import '../../../core/widgets/processing_glyph.dart';
 import '../../blocks/block_renderer.dart';
 import '../../catalog/services/artifact_lookup.dart';
 import '../view_models/reader_view_model.dart';
+import 'insight_section.dart';
 import 'primary_action_bar.dart';
 
 class ReaderScreen extends StatelessWidget {
@@ -122,6 +124,19 @@ class _ReaderView extends StatelessWidget {
                       // Action items (docs/13): follow into the Actions hub, tick off.
                       if (card.isReady && card.actionItems.isPresent)
                         _ActionItemsSection(card: card, accent: accent, vm: vm),
+                      // Deep-analysis layer (docs/14): claims, blind spots, rabbit
+                      // holes, topic map, deep-research prompt. Present only on
+                      // idea-rich cards — a simple reel renders nothing here.
+                      if (card.isReady &&
+                          card.insight != null &&
+                          card.insight!.hasContent)
+                        InsightSection(
+                          insight: card.insight!,
+                          accent: accent,
+                          cardId: card.cardId,
+                          cardTitle: card.base.oneLiner,
+                          readMinutes: _estimateReadMinutes(card),
+                        ),
                       // Referenced things (books/products/places) as tappable covers.
                       if (card.isReady) _ReferencesStrip(entries: vm.artifacts),
                       if (card.source.creator != null) ...[
@@ -140,6 +155,25 @@ class _ReaderView extends StatelessWidget {
     );
   }
 
+  /// Rough read time of the card body (~200 wpm) from its text fields — drives
+  /// the insight stat trio. Counts the tldr plus all block text content.
+  int _estimateReadMinutes(model.Card card) {
+    var words = card.base.tldr.split(RegExp(r'\s+')).where((w) => w.isNotEmpty).length;
+    for (final b in card.rawBlocks) {
+      void add(Object? v) {
+        if (v is String) words += v.split(RegExp(r'\s+')).where((w) => w.isNotEmpty).length;
+      }
+      add(b['text']);
+      for (final it in (b['items'] as List?) ?? const []) {
+        add(it is Map ? it['text'] : it);
+      }
+      for (final st in (b['steps'] as List?) ?? const []) {
+        add(st is Map ? st['text'] : st);
+      }
+    }
+    return (words / 200).ceil();
+  }
+
   void _copyUrl(BuildContext context, String url) {
     Clipboard.setData(ClipboardData(text: url));
     ScaffoldMessenger.of(context).showSnackBar(
@@ -270,9 +304,13 @@ class _ProcessingPanel extends StatelessWidget {
       child: Column(
         crossAxisAlignment: CrossAxisAlignment.start,
         children: [
-          Text('Building your card',
-              style: Theme.of(context).textTheme.titleMedium),
-          const SizedBox(height: 16),
+          const Center(child: ProcessingGlyph(size: 116)),
+          const SizedBox(height: 18),
+          Center(
+            child: Text('Building your card',
+                style: Theme.of(context).textTheme.titleMedium),
+          ),
+          const SizedBox(height: 18),
           PipelineProgress(current: stage, detail: vm.lastEvent?.detail ?? ''),
         ],
       ),
@@ -363,7 +401,7 @@ class _ReferencesStrip extends StatelessWidget {
                   ?.copyWith(fontWeight: FontWeight.w700)),
           const SizedBox(height: 12),
           SizedBox(
-            height: 150,
+            height: 168,
             child: ListView.separated(
               scrollDirection: Axis.horizontal,
               itemCount: entries.length,
@@ -440,12 +478,14 @@ class _ReferenceTile extends StatelessWidget {
               ),
             ),
             const SizedBox(height: 5),
-            Text(
-              entry.title,
-              maxLines: 2,
-              overflow: TextOverflow.ellipsis,
-              style: theme.textTheme.labelSmall
-                  ?.copyWith(fontWeight: FontWeight.w600, height: 1.15),
+            Flexible(
+              child: Text(
+                entry.title,
+                maxLines: 2,
+                overflow: TextOverflow.ellipsis,
+                style: theme.textTheme.labelSmall
+                    ?.copyWith(fontWeight: FontWeight.w600, height: 1.15),
+              ),
             ),
           ],
         ),

app/lib/ui/features/search/views/search_screen.dart

@@ -10,9 +10,12 @@ import 'package:provider/provider.dart';
 
 import '../../../../data/repositories/card_repository.dart';
 import '../../../../domain/models/card.dart' as model;
+import '../../../../domain/models/enums.dart';
+import '../../../core/brand.dart';
 import '../../../core/theme.dart';
 import '../../../core/widgets/empty_state.dart';
 import '../../../core/widgets/error_state.dart';
+import '../../capture/views/capture_sheet.dart';
 import '../../library/views/card_tile.dart';
 import '../../reader/views/reader_screen.dart';
 
@@ -31,6 +34,7 @@ class _SearchScreenState extends State<SearchScreen> {
   _Status _status = _Status.idle;
   List<model.Card> _results = const [];
   String _query = '';
+  ContentType? _filter; // null = All
 
   void _onChanged(String value) {
     _query = value.trim();
@@ -50,6 +54,7 @@ class _SearchScreenState extends State<SearchScreen> {
       if (!mounted) return;
       setState(() {
         _results = cards;
+        _filter = null; // reset filter on a fresh query
         _status = cards.isEmpty ? _Status.empty : _Status.results;
       });
     } catch (_) {
@@ -58,6 +63,20 @@ class _SearchScreenState extends State<SearchScreen> {
     }
   }
 
+  /// Content types actually present in the current results — only offer filters
+  /// that match something, in the order they appear.
+  List<ContentType> get _presentTypes {
+    final seen = <ContentType>[];
+    for (final c in _results) {
+      if (!seen.contains(c.base.contentType)) seen.add(c.base.contentType);
+    }
+    return seen;
+  }
+
+  List<model.Card> get _filtered => _filter == null
+      ? _results
+      : _results.where((c) => c.base.contentType == _filter).toList();
+
   @override
   void dispose() {
     _debounce?.cancel();
@@ -116,34 +135,146 @@ class _SearchScreenState extends State<SearchScreen> {
         return EmptyState(
           icon: Icons.search_off_rounded,
           title: 'No matches',
-          message: 'Nothing matched "$_query". Try a different word.',
+          message: 'Nothing matched "$_query". Try a different word, or capture a reel about it.',
+          actionLabel: 'Capture a reel',
+          onAction: () => showCaptureSheet(context),
         );
       case _Status.results:
         final api = context.read<CardRepository>().api;
         final cols = (MediaQuery.of(context).size.width / 200).floor().clamp(2, 5);
-        return GridView.builder(
-          padding: const EdgeInsets.all(Insets.page),
-          gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
-            crossAxisCount: cols,
-            mainAxisSpacing: Insets.block,
-            crossAxisSpacing: Insets.block,
-            childAspectRatio: 0.72,
-          ),
-          itemCount: _results.length,
-          itemBuilder: (_, i) {
-            final card = _results[i];
-            return CardTile(
-              card: card,
-              api: api,
-              onTap: () => Navigator.of(context).push(
-                MaterialPageRoute(
-                  builder: (_) => ReaderScreen(cardId: card.cardId),
+        final cards = _filtered;
+        return Column(
+          crossAxisAlignment: CrossAxisAlignment.stretch,
+          children: [
+            _FilterBar(
+              types: _presentTypes,
+              selected: _filter,
+              total: _results.length,
+              shown: cards.length,
+              onSelect: (t) => setState(() => _filter = t),
+            ),
+            Expanded(
+              child: GridView.builder(
+                padding: const EdgeInsets.fromLTRB(
+                    Insets.page, 4, Insets.page, Insets.page),
+                gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
+                  crossAxisCount: cols,
+                  mainAxisSpacing: Insets.block,
+                  crossAxisSpacing: Insets.block,
+                  childAspectRatio: 0.72,
                 ),
+                itemCount: cards.length,
+                itemBuilder: (_, i) {
+                  final card = cards[i];
+                  return CardTile(
+                    card: card,
+                    api: api,
+                    onTap: () => Navigator.of(context).push(
+                      MaterialPageRoute(
+                        builder: (_) => ReaderScreen(cardId: card.cardId),
+                      ),
+                    ),
+                    onDelete: () {},
+                  );
+                },
               ),
-              onDelete: () {},
-            );
-          },
+            ),
+          ],
         );
     }
   }
 }
+
+/// Result count + content-type filter pills above the result wall. Only shows
+/// filters for types present in the results (docs/06 search).
+class _FilterBar extends StatelessWidget {
+  const _FilterBar({
+    required this.types,
+    required this.selected,
+    required this.total,
+    required this.shown,
+    required this.onSelect,
+  });
+
+  final List<ContentType> types;
+  final ContentType? selected;
+  final int total;
+  final int shown;
+  final ValueChanged<ContentType?> onSelect;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final scheme = theme.colorScheme;
+    final count = selected == null ? total : shown;
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Padding(
+          padding: const EdgeInsets.fromLTRB(Insets.page, 10, Insets.page, 8),
+          child: Text(
+            '$count ${count == 1 ? 'result' : 'results'}',
+            style: Brand.label(
+                size: 11, color: scheme.onSurfaceVariant, weight: FontWeight.w700),
+          ),
+        ),
+        SizedBox(
+          height: 38,
+          child: ListView(
+            scrollDirection: Axis.horizontal,
+            padding: const EdgeInsets.symmetric(horizontal: Insets.page),
+            children: [
+              _Chip(
+                label: 'All',
+                selected: selected == null,
+                onTap: () => onSelect(null),
+              ),
+              for (final t in types)
+                _Chip(
+                  label: t.label,
+                  selected: selected == t,
+                  onTap: () => onSelect(t),
+                ),
+            ],
+          ),
+        ),
+      ],
+    );
+  }
+}
+
+class _Chip extends StatelessWidget {
+  const _Chip({required this.label, required this.selected, required this.onTap});
+  final String label;
+  final bool selected;
+  final VoidCallback onTap;
+
+  @override
+  Widget build(BuildContext context) {
+    final scheme = Theme.of(context).colorScheme;
+    return Padding(
+      padding: const EdgeInsets.only(right: 8),
+      child: GestureDetector(
+        onTap: onTap,
+        child: Container(
+          alignment: Alignment.center,
+          padding: const EdgeInsets.symmetric(horizontal: 14),
+          decoration: BoxDecoration(
+            color: selected ? scheme.primary : scheme.surfaceContainerHigh,
+            borderRadius: BorderRadius.circular(999),
+            border: Border.all(
+                color: selected ? scheme.primary : scheme.outlineVariant),
+          ),
+          child: Text(
+            label,
+            style: Brand.label(
+              size: 11,
+              color: selected ? scheme.onPrimary : scheme.onSurfaceVariant,
+              weight: FontWeight.w700,
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}

app/lib/ui/features/share/views/share_screen.dart

@@ -15,6 +15,7 @@ import '../../../core/brand.dart';
 import '../../../core/theme.dart';
 import '../../../core/widgets/error_state.dart';
 import '../../../core/widgets/pipeline_progress.dart';
+import '../../../core/widgets/processing_glyph.dart';
 import '../../reader/views/reader_screen.dart';
 import '../view_models/share_view_model.dart';
 
@@ -76,8 +77,8 @@ class _ShareView extends StatelessWidget {
           child: Column(
             mainAxisSize: MainAxisSize.min,
             children: [
-              CircularProgressIndicator(color: theme.colorScheme.primary),
-              const SizedBox(height: 16),
+              const ProcessingGlyph(size: 132),
+              const SizedBox(height: 20),
               const Text('Sending to Cachy…'),
             ],
           ),
@@ -125,6 +126,8 @@ class _ShareView extends StatelessWidget {
         return Column(
           crossAxisAlignment: CrossAxisAlignment.start,
           children: [
+            const Center(child: ProcessingGlyph(size: 132)),
+            const SizedBox(height: 24),
             Text('Building your card', style: theme.textTheme.headlineSmall),
             const SizedBox(height: 8),
             Text(

backend/app/models/card.py

@@ -13,7 +13,7 @@ from typing import Annotated, Literal, Optional, Union
 
 from pydantic import BaseModel, Field
 
-SCHEMA_VERSION = "1.3"  # 1.1: artifacts list (docs/12); 1.2: base.tags (docs/09); 1.3: action_items (docs/13)
+SCHEMA_VERSION = "1.4"  # 1.1: artifacts list (docs/12); 1.2: base.tags (docs/09); 1.3: action_items (docs/13); 1.4: insight layer (docs/14)
 
 
 # --------------------------------------------------------------------------- #
@@ -217,6 +217,50 @@ class ActionItems(BaseModel):
     items: list[ActionItem] = Field(default_factory=list)
 
 
+# --------------------------------------------------------------------------- #
+# Insight layer (docs/14) — the optional "deep" analysis. Populated by a SECOND,
+# gated LLM pass ONLY for knowledge-rich cards; a simple reel (recipe, a quick
+# tip) carries `insight = None` and renders none of this. Within a deep card each
+# sub-section is independently optional — emit only what the content warrants.
+#
+# Everything here is ACTIONABLE, never a passive list: rabbit-hole threads are
+# tappable doorways into grounded chat, the topic map orients, and the research
+# prompt is paste-ready. (Earlier Claims / What's-Missing sections were removed —
+# read-only analysis with nothing to do.)
+# --------------------------------------------------------------------------- #
+
+class RabbitHole(BaseModel):
+    """Threads to pull on to go deeper. Each becomes a tappable prompt in the UI
+    (opens grounded chat). Each list is independently optional."""
+    questions: list[str] = Field(default_factory=list)
+    adjacent_topics: list[str] = Field(default_factory=list)
+    advanced_concepts: list[str] = Field(default_factory=list)
+
+    def is_empty(self) -> bool:
+        return not (self.questions or self.adjacent_topics or self.advanced_concepts)
+
+
+class TopicMap(BaseModel):
+    """A single-hop concept map: one center idea + a few connected satellites."""
+    center: str
+    nodes: list[str] = Field(default_factory=list)  # satellite labels
+
+
+class Insight(BaseModel):
+    rabbit_hole: RabbitHole = Field(default_factory=RabbitHole)
+    topic_map: Optional[TopicMap] = None
+    # A ready-to-paste deep-research prompt for an external LLM (docs/14).
+    deep_research_prompt: Optional[str] = None
+
+    def has_content(self) -> bool:
+        """True when at least one sub-section is non-empty — the gate the worker
+        and clients use to decide whether to attach/render the layer at all."""
+        return bool(
+            not self.rabbit_hole.is_empty()
+            or self.topic_map or self.deep_research_prompt
+        )
+
+
 class Media(BaseModel):
     thumbnail: Optional[str] = None
     keyframes: list[str] = Field(default_factory=list)
@@ -246,5 +290,7 @@ class Card(BaseModel):
     primary_action: PrimaryAction = Field(default_factory=PrimaryAction)
     action_items: ActionItems = Field(default_factory=ActionItems)
     blocks: list[Block] = Field(default_factory=list)
+    # Deep analysis (docs/14). None for simple cards; only the gated 2nd pass fills it.
+    insight: Optional[Insight] = None
     media: Media = Field(default_factory=Media)
     meta: Meta = Field(default_factory=Meta)

backend/app/pipeline/insight.py

@@ -0,0 +1,175 @@
+"""Insight analysis (docs/14): the GATED second pass. Runs ONLY for cards the
+structuring pass judged `depth == "deep"`. One text-only LLM call turns the card's
+own summary + body into a reasoning layer — claims, blind spots, rabbit holes, a
+small topic map, and a ready-to-paste deep-research prompt.
+
+Same discipline as structuring: never trust the model. Every field is validated
+and independently optional; a malformed or empty result yields `None` (no layer),
+never a crash. A simple reel never reaches this module.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+
+from app.models.card import (
+    Insight,
+    RabbitHole,
+    TopicMap,
+)
+from app.pipeline.structuring import complete, _strip_fences
+
+log = logging.getLogger("pipeline.insight")
+
+_MAX = {
+    "questions": 6,
+    "adjacent_topics": 6,
+    "advanced_concepts": 5,
+    "nodes": 6,
+}
+
+_PROMPT = """You are a sharp analyst. You are given a knowledge card distilled from a
+short-form video on an idea-rich topic. Produce a DEEP ANALYSIS layer — the
+scaffolding a curious person would use to go FURTHER than the video. Everything
+must be something the reader can act on, not passive commentary.
+
+Return ONLY a JSON object (no prose, no markdown fences) with this exact shape:
+{{
+  "rabbit_hole": {{           // threads to go deeper; each becomes a tappable
+                              // question the reader can ask an AI. Each list may be empty.
+    "questions": [str],            // sharp open questions the content raises
+    "adjacent_topics": [str],      // neighbouring subjects worth exploring
+    "advanced_concepts": [str]     // next-level ideas for someone who gets the basics
+  }},
+  "topic_map": {{             // a one-hop concept map, or null if not meaningful
+    "center": str,                 // the core idea (1-3 words)
+    "nodes": [str]                 // 3-6 connected concepts (1-3 words each)
+  }},
+  "deep_research_prompt": str // a ready-to-paste prompt for an external LLM (see below)
+}}
+
+Rules:
+- Ground EVERY item in the card's actual content. Do not invent. If the card is
+  thin, return fewer items — an empty list is correct when there is nothing real
+  to say. Never pad.
+- rabbit_hole: phrase questions/topics so they make sense as a prompt the reader
+  taps to ask an AI (e.g. "How does compound interest differ from simple
+  interest?", "Behavioural economics of saving"). Concrete, specific, self-contained.
+- topic_map: only when the content genuinely connects several concepts. If it is a
+  single narrow point, set "topic_map": null.
+- deep_research_prompt: a structured, rigorous research brief (research objectives,
+  desired output sections, constraints) an expert could paste into a frontier LLM to
+  go far beyond this video. Plain text, ~150-350 words, no markdown headers. Omit it
+  (use null) only if the topic does not reward independent research.
+- Output strict JSON. No commentary.
+
+Card:
+---
+{card}
+---
+"""
+
+
+def _card_digest(one_liner: str, tldr: str, body: str, tags: list[str]) -> str:
+    """A compact text view of the card for the analysis prompt."""
+    parts = []
+    if one_liner:
+        parts.append(f"ONE-LINER: {one_liner}")
+    if tldr:
+        parts.append(f"SUMMARY: {tldr}")
+    if tags:
+        parts.append("TAGS: " + ", ".join(tags))
+    if body:
+        parts.append("BODY:\n" + body[:4000])
+    return "\n\n".join(parts).strip()
+
+
+# --------------------------------------------------------------------------- #
+# Validation — never trust the model
+# --------------------------------------------------------------------------- #
+
+def _clean_str(value, limit: int = 400) -> str:
+    if not isinstance(value, str):
+        return ""
+    return " ".join(value.split()).strip()[:limit]
+
+
+def _str_list(raw, cap: int) -> list[str]:
+    out: list[str] = []
+    if not isinstance(raw, list):
+        return out
+    seen: set[str] = set()
+    for item in raw:
+        text = _clean_str(item)
+        if not text or text.lower() in seen:
+            continue
+        seen.add(text.lower())
+        out.append(text)
+        if len(out) >= cap:
+            break
+    return out
+
+
+def _validate(raw_text: str) -> Insight | None:
+    try:
+        data = json.loads(_strip_fences(raw_text))
+    except (json.JSONDecodeError, TypeError):
+        log.warning("insight: LLM output was not valid JSON -> no insight layer")
+        return None
+    if not isinstance(data, dict):
+        return None
+
+    rh_raw = data.get("rabbit_hole") if isinstance(data.get("rabbit_hole"), dict) else {}
+    rabbit_hole = RabbitHole(
+        questions=_str_list(rh_raw.get("questions"), _MAX["questions"]),
+        adjacent_topics=_str_list(rh_raw.get("adjacent_topics"), _MAX["adjacent_topics"]),
+        advanced_concepts=_str_list(
+            rh_raw.get("advanced_concepts"), _MAX["advanced_concepts"]
+        ),
+    )
+
+    topic_map = None
+    tm_raw = data.get("topic_map")
+    if isinstance(tm_raw, dict):
+        center = _clean_str(tm_raw.get("center"), limit=60)
+        nodes = _str_list(tm_raw.get("nodes"), _MAX["nodes"])
+        if center and len(nodes) >= 2:  # a center with <2 satellites is not a map
+            topic_map = TopicMap(center=center, nodes=nodes)
+
+    deep_research_prompt = _clean_str(data.get("deep_research_prompt"), limit=4000) or None
+
+    insight = Insight(
+        rabbit_hole=rabbit_hole,
+        topic_map=topic_map,
+        deep_research_prompt=deep_research_prompt,
+    )
+    # Drop a layer that came back empty after validation — render nothing rather
+    # than an empty shell (docs/14).
+    return insight if insight.has_content() else None
+
+
+# --------------------------------------------------------------------------- #
+# Entry point
+# --------------------------------------------------------------------------- #
+
+def analyze(one_liner: str, tldr: str, body: str, tags: list[str]) -> Insight | None:
+    """Run the gated second pass. Returns a validated Insight, or None when the
+    backend is unavailable / the model returns nothing usable. Caller (worker)
+    treats None as "no insight layer" — never an error."""
+    card = _card_digest(one_liner, tldr, body, tags)
+    if not card:
+        return None
+    raw = complete(_PROMPT.format(card=card), max_tokens=4096)
+    if not raw:
+        log.info("insight: no LLM output -> skipping insight layer")
+        return None
+    return _validate(raw)
+
+
+async def analyze_async(
+    one_liner: str, tldr: str, body: str, tags: list[str]
+) -> Insight | None:
+    import asyncio
+
+    return await asyncio.to_thread(analyze, one_liner, tldr, body, tags)

backend/app/pipeline/structuring.py

@@ -69,6 +69,7 @@ class StructuredCard:
         primary_action: PrimaryAction,
         artifacts: list[Artifact] | None = None,
         action_items: ActionItems | None = None,
+        depth: str = "shallow",
         degraded: bool = False,
         degraded_reason: str = "",
     ):
@@ -76,6 +77,10 @@ class StructuredCard:
         self.blocks = blocks  # list of plain dicts (validated), ready for JSON column
         self.primary_action = primary_action
         self.artifacts = artifacts or []  # referenced things for the catalog (docs/12)
+        # Gate for the 2nd pass (docs/14): "deep" => run insight analysis;
+        # "shallow" => simple card, no extra LLM call. The model judges; the worker
+        # acts. Never block the card on this — default shallow.
+        self.depth = depth if depth in ("shallow", "deep") else "shallow"
         # Concrete to-dos the video tells the viewer to do (docs/13). Inert
         # (followed=False) at ingestion; the user opts a card into the hub later.
         self.action_items = action_items or ActionItems()
@@ -140,7 +145,8 @@ Return ONLY a JSON object (no prose, no markdown fences) with this exact shape:
   ],
   "action_items": [          // concrete things the viewer should DO (may be empty)
     str                      // one short imperative task, e.g. "Batch emails into two daily windows"
-  ]
+  ],
+  "depth": "shallow|deep"    // does this content warrant deep analysis? (see below)
 }}
 
 Rules:
@@ -161,6 +167,13 @@ Rules:
   Short imperative phrases, max ~8. These are the takeaways to act on, NOT a
   restatement of every step in a recipe/tutorial. Return an empty list if the
   video is purely informational with nothing to act on.
+- depth: judge whether this content rewards DEEPER analysis (claims to fact-check,
+  unstated assumptions, open questions, a web of related concepts). Answer "deep"
+  ONLY for idea-rich, knowledge-heavy, or argumentative content (e.g. a science
+  explainer, an investing thesis, a psychology breakdown, a contested take).
+  Answer "shallow" for practical/procedural or lightweight content with nothing
+  to interrogate (a recipe, a workout, a product list, a quick how-to, a meme).
+  When unsure, answer "shallow". Most videos are shallow.
 
 {vocab}
 
@@ -175,62 +188,66 @@ Extracted text bundle:
 # LLM call (selectable backend: huggingface | groq)
 # --------------------------------------------------------------------------- #
 
-def _call_llm(bundle: str) -> str | None:
-    """Dispatch to the configured structuring backend. Any failure -> None,
-    which the caller turns into a paragraph fallback."""
+def complete(prompt: str, *, max_tokens: int = 8192, temperature: float = 0.2) -> str | None:
+    """Generic single-prompt completion via the configured backend (HF, with a
+    Groq fallback). Shared by the structuring pass and the gated insight pass
+    (docs/14). Any failure -> None; callers decide how to degrade."""
     settings = get_settings()
     if settings.hf_enabled:
-        out = _call_hf(bundle)
+        out = _call_hf(prompt, max_tokens, temperature)
         if out:
             return out
         # HF's free router 504s on long generations (e.g. big carousels). Rather
-        # than drop straight to a paragraph, fall back to Groq when a key exists.
+        # than drop straight to failure, fall back to Groq when a key exists.
         if settings.groq_api_key.strip():
-            log.info("structuring: HF backend failed; falling back to Groq")
-            return _call_groq(bundle)
+            log.info("llm: HF backend failed; falling back to Groq")
+            return _call_groq(prompt, max_tokens, temperature)
         return None
     if settings.groq_llm_enabled:
-        return _call_groq(bundle)
+        return _call_groq(prompt, max_tokens, temperature)
     return None
 
 
-def _call_hf(bundle: str) -> str | None:
+def _call_llm(bundle: str) -> str | None:
+    """Structuring (pass 1): format the card prompt and complete it."""
+    return complete(_PROMPT.format(vocab=_VOCAB_SPEC, bundle=bundle))
+
+
+def _call_hf(prompt: str, max_tokens: int, temperature: float) -> str | None:
     settings = get_settings()
     try:
         from huggingface_hub import InferenceClient
 
         client = InferenceClient(api_key=settings.hf_api_key)
-        prompt = _PROMPT.format(vocab=_VOCAB_SPEC, bundle=bundle)
         resp = client.chat_completion(
             model=settings.hf_model,  # free Inference Providers, e.g. Qwen2.5-72B-Instruct
             messages=[{"role": "user", "content": prompt}],
-            temperature=0.2,
-            max_tokens=8192,  # rich carousels (e.g. 140-item lists) overflow a smaller cap
+            temperature=temperature,
+            max_tokens=max_tokens,  # rich carousels (e.g. 140-item lists) overflow a smaller cap
         )
         text = resp.choices[0].message.content if resp.choices else ""
         return (text or "").strip()
     except Exception as e:
-        log.warning("structuring call (huggingface) failed: %s", e)
+        log.warning("llm call (huggingface) failed: %s", e)
         return None
 
 
-def _call_groq(bundle: str) -> str | None:
+def _call_groq(prompt: str, max_tokens: int, temperature: float) -> str | None:
     settings = get_settings()
     try:
         from groq import Groq
 
         client = Groq(api_key=settings.groq_api_key)
-        prompt = _PROMPT.format(vocab=_VOCAB_SPEC, bundle=bundle)
         resp = client.chat.completions.create(
             model=settings.groq_llm_model,  # free tier; default llama-3.3-70b-versatile
             messages=[{"role": "user", "content": prompt}],
-            temperature=0.2,
-            max_tokens=8192,  # rich carousels (e.g. 140-item lists) overflow a smaller cap
+            temperature=temperature,
+            max_tokens=max_tokens,  # rich carousels (e.g. 140-item lists) overflow a smaller cap
         )
         text = resp.choices[0].message.content if resp.choices else ""
         return (text or "").strip()
     except Exception as e:
-        log.warning("structuring call (groq) failed: %s", e)
+        log.warning("llm call (groq) failed: %s", e)
         return None
 
 
@@ -417,6 +434,7 @@ def _validate(raw_text: str, bundle: str, transcript: str, caption: str) -> "Str
 
     artifacts = _coerce_artifacts(data.get("artifacts") or [])
     action_items = _coerce_action_items(data.get("action_items") or [])
+    depth = data.get("depth") if data.get("depth") in ("shallow", "deep") else "shallow"
 
     blocks = _coerce_blocks(data.get("blocks") or [])
     if not blocks:
@@ -434,7 +452,7 @@ def _validate(raw_text: str, bundle: str, transcript: str, caption: str) -> "Str
 
     return StructuredCard(
         base, blocks, _primary_action_for(base.content_type), artifacts,
-        action_items=action_items,
+        action_items=action_items, depth=depth,
     )
 
 

backend/app/pipeline/worker.py

@@ -25,6 +25,7 @@ from app.pipeline.ingestion.downloader import (
     DownloaderConfig,
     download_content_async,
 )
+from app.pipeline.insight import analyze_async
 from app.pipeline.structuring import structure_async
 from app.services import artifact_images, embeddings, events, llm_chat, notify
 from app.store import db, media
@@ -105,6 +106,16 @@ async def _write_blocks(session, card_id: str, blocks: list[dict]) -> None:
     await session.commit()
 
 
+async def _write_insight(session, card_id: str, insight) -> None:
+    """Persist the deep-analysis layer (docs/14). `insight` is a validated model."""
+    await session.execute(
+        update(db.CardRow)
+        .where(db.CardRow.id == card_id)
+        .values(insight=insight.model_dump())
+    )
+    await session.commit()
+
+
 async def _write_media_and_meta(
     session, card_id: str, extraction, caption: str, resolver: str,
     creator: str | None = None,
@@ -291,6 +302,37 @@ async def _run_job(session, job: db.JobRow) -> None:
         creator=download.author,
     )
 
+    # 4b) Deep analysis (docs/14) — GATED. Only idea-rich cards (the structuring
+    # pass judged `depth == "deep"`) get a second LLM call. A simple reel skips
+    # this entirely. Best-effort + isolated: a failure leaves insight=None and
+    # never blocks the card from going READY.
+    if structured.depth == "deep":
+        events.publish(card_id, "analyzing", "processing", "Analyzing in depth")
+        log.info("%s Step 4b deep-analysis: depth=deep -> running insight pass", tag)
+        try:
+            row = await db.get_card_row(session, card_id)
+            body = llm_chat.card_context(row.to_card()) if row else ""
+            insight = await analyze_async(
+                structured.base.one_liner, structured.base.tldr, body,
+                structured.base.tags,
+            )
+            if insight is not None:
+                await _write_insight(session, card_id, insight)
+                rh = insight.rabbit_hole
+                log.info(
+                    "%s Step 4b deep-analysis OK | threads=%d topic_map=%s "
+                    "deep_research=%s", tag,
+                    len(rh.questions) + len(rh.adjacent_topics) + len(rh.advanced_concepts),
+                    "yes" if insight.topic_map else "no",
+                    "yes" if insight.deep_research_prompt else "no",
+                )
+            else:
+                log.info("%s Step 4b deep-analysis: no usable layer produced", tag)
+        except Exception:  # noqa: BLE001 — insight is non-critical to the card
+            log.warning("%s Step 4b deep-analysis failed", tag, exc_info=True)
+    else:
+        log.info("%s Step 4b deep-analysis: depth=shallow, skipping", tag)
+
     # 5) Catalog: aggregate any referenced artifacts + fetch their thumbnails.
     if structured.artifacts:
         events.publish(card_id, "cataloging", "processing", "Cataloging references")

backend/app/store/db.py

@@ -35,6 +35,7 @@ from app.models.card import (
     CardState,
     ExtractionFlags,
     FailureReason,
+    Insight,
     Media,
     Meta,
     PrimaryAction,
@@ -81,6 +82,8 @@ class CardRow(Base):
     # {followed: bool, items: [{id, text, done}]} — the to-do list (docs/13).
     action_items: Mapped[dict | None] = mapped_column(JSON, nullable=True)
     blocks: Mapped[list] = mapped_column(JSON, default=list)
+    # Deep-analysis layer (docs/14): null for simple cards, filled by the gated pass.
+    insight: Mapped[dict | None] = mapped_column(JSON, nullable=True)
     thumbnail: Mapped[str | None] = mapped_column(String, nullable=True)
     keyframes: Mapped[list | None] = mapped_column(JSON, nullable=True)
     extraction: Mapped[dict | None] = mapped_column(JSON, nullable=True)
@@ -118,6 +121,7 @@ class CardRow(Base):
             primary_action=PrimaryAction(**(self.primary_action or {})),
             action_items=ActionItems(**(self.action_items or {})),
             blocks=self.blocks or [],
+            insight=Insight(**self.insight) if self.insight else None,
             media=Media(
                 thumbnail=media_store.to_media_url(self.thumbnail),
                 keyframes=[
@@ -218,7 +222,10 @@ async def init_db() -> None:
         await _add_missing_columns(
             conn,
             "cards",
-            {"action_items": "JSON"},  # docs/13 — added in schema 1.3
+            {
+                "action_items": "JSON",  # docs/13 — added in schema 1.3
+                "insight": "JSON",  # docs/14 — added in schema 1.4
+            },
         )
 
 

backend/tests/test_api.py

@@ -18,7 +18,7 @@ async def client(database):
 async def test_health(client):
     r = await client.get("/health")
     assert r.status_code == 200
-    assert r.json()["schema_version"] == "1.3"
+    assert r.json()["schema_version"] == "1.4"
 
 
 async def test_create_returns_id_and_queued(client):