[Developer] #204 Phase 1 MVP — Flutter app skeleton complete

- Drift 21 tables (8 catalog + 11 user + habit_dose_variants + meta_kv)
  with R1~R10 CHECK constraints and 19 indexes
- 8 hand-crafted seed JSON catalogs in app/assets/seed/
  (refs 84, protocols 34, methodologies 21, frame_patterns 30,
   reward_menu_items 30, break_protocols 8, common_frames 5, diet_patterns 5)
- 6 domain functions: recommend_variant, compute_streak,
  validate_frame_level, active_habit_quota, weekly_minimum_ratio,
  seed_importer (transactional, idempotent)
- 4 vertical-slice Riverpod screens: HabitList, HabitCreate, CheckIn, Streak
- 31 unit tests passing; flutter analyze clean
- OQ-5 streak semantics: missing entry ≠ explicit blank
  (missing = end of history; only TrackerValue.blank triggers Never-miss-twice)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

app/test/domain/frame/validate_frame_level_test.dart

@@ -0,0 +1,86 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:life_helper/domain/frame/validate_frame_level.dart';
+import 'package:life_helper/domain/models/frame_pattern.dart';
+import 'package:life_helper/domain/models/habit.dart';
+
+final _patterns = <FramePatternModel>[
+  const FramePatternModel(
+    id: 'fp_alcohol',
+    domain: 'drink',
+    avoidanceKeyword: '술 끊기',
+    l0Example: '술 끊기',
+    l1SimpleReplace: '음주 중단',
+    l2Suggestion: '저녁엔 무알콜 음료 마시기',
+    l3Identity: '나는 맑은 정신을 우선시하는 사람이다',
+  ),
+  const FramePatternModel(
+    id: 'fp_general',
+    domain: 'general',
+    avoidanceKeyword: '안 하기',
+    l0Example: '안 하기',
+    l2Suggestion: '대신 다른 행동 정의하기',
+  ),
+];
+
+void main() {
+  test('empty framed text → reject', () {
+    final r = validateFrameLevel(
+      const FrameInput(level: FrameLevel.l2, framedText: ''),
+      knownPatterns: _patterns,
+    );
+    expect(r.status, FrameValidationStatus.reject);
+  });
+
+  test('L0 → reject + suggestions', () {
+    final r = validateFrameLevel(
+      const FrameInput(level: FrameLevel.l0, framedText: '술 끊기'),
+      knownPatterns: _patterns,
+    );
+    expect(r.status, FrameValidationStatus.reject);
+    expect(r.suggestions, isNotEmpty);
+    expect(r.suggestions.any((s) => s.level == FrameLevel.l2), true);
+  });
+
+  test('L1 → reject + suggestions even when not matching any keyword', () {
+    final r = validateFrameLevel(
+      const FrameInput(level: FrameLevel.l1, framedText: '담배 줄이기'),
+      knownPatterns: _patterns,
+    );
+    expect(r.status, FrameValidationStatus.reject);
+    // Should fall back to 'general' domain suggestion.
+    expect(r.suggestions, isNotEmpty);
+  });
+
+  test('L2 clean → accept', () {
+    final r = validateFrameLevel(
+      const FrameInput(level: FrameLevel.l2, framedText: '저녁엔 무알콜 음료 마시기'),
+      knownPatterns: _patterns,
+    );
+    expect(r.status, FrameValidationStatus.accept);
+    expect(r.suggestions, isEmpty);
+  });
+
+  test('L2 with embedded avoidance keyword → warn', () {
+    final r = validateFrameLevel(
+      const FrameInput(level: FrameLevel.l2, framedText: '술 끊기로 다짐'),
+      knownPatterns: _patterns,
+    );
+    expect(r.status, FrameValidationStatus.warn);
+    expect(r.avoidanceHits, isNotEmpty);
+    expect(r.avoidanceHits.first.keyword, '술 끊기');
+  });
+
+  test('L3 identity frame, clean → accept', () {
+    final r = validateFrameLevel(
+      const FrameInput(level: FrameLevel.l3, framedText: '나는 맑은 정신을 우선시한다'),
+      knownPatterns: _patterns,
+    );
+    expect(r.status, FrameValidationStatus.accept);
+  });
+
+  test('detectAvoidanceKeywords finds multiple occurrences', () {
+    final hits =
+        detectAvoidanceKeywords('술 끊기 / 다시 술 끊기 / 끝', _patterns);
+    expect(hits.length, 2);
+  });
+}

app/test/domain/recommend/recommend_variant_test.dart

@@ -0,0 +1,96 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:life_helper/domain/models/habit.dart';
+import 'package:life_helper/domain/recommend/recommend_variant.dart';
+
+HabitModel _habit(List<HabitDoseVariantModel> variants) => HabitModel(
+      id: 'hb_x',
+      userId: 'u_local_default',
+      type: HabitType.build,
+      status: HabitStatus.active,
+      title: 't',
+      protocolId: 'p',
+      frameLevel: FrameLevel.l2,
+      frameFramedText: 't',
+      startedAt: '2026-06-01',
+      doseVariants: variants,
+    );
+
+HabitDoseVariantModel _v({
+  required String id,
+  required int sort,
+  bool isMin = false,
+  List<String> ctx = const [],
+  List<String> cond = const [],
+}) =>
+    HabitDoseVariantModel(
+      variantId: id,
+      habitId: 'hb_x',
+      label: id,
+      doseText: '1x',
+      contextTags: ctx,
+      conditionTags: cond,
+      isMinimum: isMin,
+      sortOrder: sort,
+    );
+
+void main() {
+  test('empty variants → null', () {
+    expect(recommendVariant(_habit(const []), const CheckInContext()), isNull);
+  });
+
+  test('exact match wins (location + condition, score 4)', () {
+    final habit = _habit([
+      _v(id: 'A', sort: 0, ctx: ['집']),
+      _v(id: 'B', sort: 1, ctx: ['회사'], cond: ['좋음']),
+      _v(id: 'C', sort: 2, isMin: true),
+    ]);
+    final pick = recommendVariant(
+        habit, const CheckInContext(location: '회사', condition: '좋음'));
+    expect(pick!.variant.variantId, 'B');
+    expect(pick.reason, RecommendReason.exactMatch);
+    expect(pick.score, 4);
+  });
+
+  test('partial match (only location)', () {
+    final habit = _habit([
+      _v(id: 'A', sort: 0, ctx: ['집']),
+      _v(id: 'B', sort: 1, ctx: ['회사']),
+    ]);
+    final pick = recommendVariant(habit, const CheckInContext(location: '집'));
+    expect(pick!.variant.variantId, 'A');
+    expect(pick.reason, RecommendReason.partial);
+    expect(pick.score, 2);
+  });
+
+  test('fallback to minimum when nothing matches', () {
+    final habit = _habit([
+      _v(id: 'A', sort: 0, ctx: ['집']),
+      _v(id: 'B', sort: 1, isMin: true),
+    ]);
+    final pick = recommendVariant(
+        habit, const CheckInContext(location: '카페', condition: '나쁨'));
+    // is_minimum + condition=='나쁨' → score 1 → partial pick, not fallback.
+    expect(pick!.variant.variantId, 'B');
+    expect(pick.reason, RecommendReason.partial);
+  });
+
+  test('fallback to first by sortOrder when no minimum, no match', () {
+    final habit = _habit([
+      _v(id: 'A', sort: 5, ctx: ['집']),
+      _v(id: 'B', sort: 2, ctx: ['회사']),
+    ]);
+    final pick = recommendVariant(habit, const CheckInContext(location: '카페'));
+    expect(pick!.variant.variantId, 'B');
+    expect(pick.reason, RecommendReason.fallbackFirst);
+    expect(pick.score, 0);
+  });
+
+  test('tie-break: same score → smaller sortOrder wins', () {
+    final habit = _habit([
+      _v(id: 'A', sort: 10, ctx: ['집']),
+      _v(id: 'B', sort: 1, ctx: ['집']),
+    ]);
+    final pick = recommendVariant(habit, const CheckInContext(location: '집'));
+    expect(pick!.variant.variantId, 'B');
+  });
+}

app/test/domain/rules/active_habit_quota_test.dart

@@ -0,0 +1,38 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:life_helper/domain/models/habit.dart';
+import 'package:life_helper/domain/rules/active_habit_quota.dart';
+
+void main() {
+  test('build allows up to 3', () {
+    expect(
+      judgeActiveHabitQuota(type: HabitType.build, currentActiveCount: 2).allowed,
+      true,
+    );
+    expect(
+      judgeActiveHabitQuota(type: HabitType.build, currentActiveCount: 3).allowed,
+      false,
+    );
+  });
+
+  test('break allows only 1', () {
+    expect(
+      judgeActiveHabitQuota(type: HabitType.breakHabit, currentActiveCount: 0)
+          .allowed,
+      true,
+    );
+    expect(
+      judgeActiveHabitQuota(type: HabitType.breakHabit, currentActiveCount: 1)
+          .allowed,
+      false,
+    );
+  });
+
+  test('reason describes the limit when blocked', () {
+    final r = judgeActiveHabitQuota(
+        type: HabitType.build, currentActiveCount: 3);
+    expect(r.reason, contains('3'));
+    final br = judgeActiveHabitQuota(
+        type: HabitType.breakHabit, currentActiveCount: 1);
+    expect(br.reason, contains('1'));
+  });
+}

app/test/domain/streak/compute_streak_test.dart

@@ -0,0 +1,115 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:life_helper/domain/models/tracker_entry.dart';
+import 'package:life_helper/domain/streak/compute_streak.dart';
+
+TrackerEntryModel _e(String date, TrackerValue v) =>
+    TrackerEntryModel(id: 'te_$date', habitId: 'hb', date: date, value: v);
+
+void main() {
+  group('computeStreak', () {
+    test('empty → all zero, T0, not broken', () {
+      final s = computeStreak(
+        entries: const [],
+        asOf: DateTime(2026, 6, 11),
+        habitStartedAt: '2026-06-01',
+      );
+      expect(s.currentStreak, 0);
+      expect(s.currentTier, RewardTier.t0);
+      expect(s.neverMissTwiceBroken, false);
+    });
+
+    test('3 consecutive done → T1', () {
+      final s = computeStreak(
+        entries: [
+          _e('2026-06-09', TrackerValue.done),
+          _e('2026-06-10', TrackerValue.done),
+          _e('2026-06-11', TrackerValue.done),
+        ],
+        asOf: DateTime(2026, 6, 11),
+        habitStartedAt: '2026-06-01',
+      );
+      expect(s.currentStreak, 3);
+      expect(s.currentTier, RewardTier.t1);
+    });
+
+    test('7 consecutive done → T2', () {
+      final entries = <TrackerEntryModel>[];
+      for (var i = 0; i < 7; i++) {
+        final d = DateTime(2026, 6, 5).add(Duration(days: i));
+        entries.add(_e(_ymd(d), TrackerValue.done));
+      }
+      final s = computeStreak(
+        entries: entries,
+        asOf: DateTime(2026, 6, 11),
+        habitStartedAt: '2026-06-01',
+      );
+      expect(s.currentStreak, 7);
+      expect(s.currentTier, RewardTier.t2);
+    });
+
+    test('OQ-5: 1 blank → streak=0, tier stays (not broken)', () {
+      // 6/9 done, 6/10 blank entry, 6/11 done.
+      final s = computeStreak(
+        entries: [
+          _e('2026-06-09', TrackerValue.done),
+          _e('2026-06-10', TrackerValue.blank),
+          _e('2026-06-11', TrackerValue.done),
+        ],
+        asOf: DateTime(2026, 6, 11),
+        habitStartedAt: '2026-06-01',
+      );
+      // Walks back: 6/11 done (+1), 6/10 blank → streak resets to 0.
+      expect(s.currentStreak, 0);
+      expect(s.neverMissTwiceBroken, false);
+    });
+
+    test('OQ-5: 2 consecutive blank → neverMissTwiceBroken=true', () {
+      final s = computeStreak(
+        entries: [
+          _e('2026-06-09', TrackerValue.done),
+          _e('2026-06-10', TrackerValue.blank),
+          _e('2026-06-11', TrackerValue.blank),
+        ],
+        asOf: DateTime(2026, 6, 11),
+        habitStartedAt: '2026-06-01',
+      );
+      expect(s.currentStreak, 0);
+      expect(s.neverMissTwiceBroken, true);
+    });
+
+    test('window30: 24/30 done → T3', () {
+      final entries = <TrackerEntryModel>[];
+      // 24 done in last 30 days, but not as a streak.
+      for (var i = 0; i < 24; i++) {
+        final d = DateTime(2026, 6, 11).subtract(Duration(days: i));
+        entries.add(_e(_ymd(d), TrackerValue.done));
+      }
+      final s = computeStreak(
+        entries: entries,
+        asOf: DateTime(2026, 6, 11),
+        habitStartedAt: '2026-05-01',
+      );
+      expect(s.doneCountInWindow30, 24);
+      expect(s.currentTier.rank, greaterThanOrEqualTo(RewardTier.t3.rank));
+    });
+
+    test('longestStreak picks largest run regardless of current', () {
+      final s = computeStreak(
+        entries: [
+          for (final d in ['2026-06-01', '2026-06-02', '2026-06-03', '2026-06-04'])
+            _e(d, TrackerValue.done),
+          _e('2026-06-05', TrackerValue.blank),
+          _e('2026-06-11', TrackerValue.done),
+        ],
+        asOf: DateTime(2026, 6, 11),
+        habitStartedAt: '2026-06-01',
+      );
+      expect(s.longestStreak, 4);
+    });
+  });
+}
+
+String _ymd(DateTime d) =>
+    '${d.year.toString().padLeft(4, '0')}-'
+    '${d.month.toString().padLeft(2, '0')}-'
+    '${d.day.toString().padLeft(2, '0')}';

app/test/domain/streak/weekly_minimum_ratio_test.dart

@@ -0,0 +1,81 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:life_helper/domain/models/habit.dart';
+import 'package:life_helper/domain/models/tracker_entry.dart';
+import 'package:life_helper/domain/streak/weekly_minimum_ratio.dart';
+
+HabitDoseVariantModel _v(String id, {bool isMin = false}) =>
+    HabitDoseVariantModel(
+      variantId: id,
+      habitId: 'hb',
+      label: id,
+      doseText: '1x',
+      isMinimum: isMin,
+    );
+
+TrackerEntryModel _done(String date, {String? vId}) => TrackerEntryModel(
+      id: 'te_$date',
+      habitId: 'hb',
+      date: date,
+      value: TrackerValue.done,
+      variantId: vId,
+    );
+
+void main() {
+  final variantsById = {
+    'min': _v('min', isMin: true),
+    'full': _v('full'),
+  };
+
+  test('no done entries → ratio 0.0', () {
+    final r = computeWeeklyMinimumRatio(
+      entries: const [],
+      variantsById: variantsById,
+      asOf: DateTime(2026, 6, 11),
+    );
+    expect(r.totalDone, 0);
+    expect(r.ratio, 0.0);
+  });
+
+  test('3 of 4 used minimum → 0.75', () {
+    final r = computeWeeklyMinimumRatio(
+      entries: [
+        _done('2026-06-08', vId: 'min'),
+        _done('2026-06-09', vId: 'min'),
+        _done('2026-06-10', vId: 'full'),
+        _done('2026-06-11', vId: 'min'),
+      ],
+      variantsById: variantsById,
+      asOf: DateTime(2026, 6, 11),
+    );
+    expect(r.totalDone, 4);
+    expect(r.minimumUsed, 3);
+    expect(r.ratio, closeTo(0.75, 1e-9));
+  });
+
+  test('out-of-window entries are excluded', () {
+    final r = computeWeeklyMinimumRatio(
+      entries: [
+        _done('2026-06-01', vId: 'min'), // 10 days before asOf
+        _done('2026-06-11', vId: 'min'),
+      ],
+      variantsById: variantsById,
+      asOf: DateTime(2026, 6, 11),
+    );
+    expect(r.totalDone, 1);
+    expect(r.minimumUsed, 1);
+  });
+
+  test('done with null variantId counts as totalDone but not minimumUsed', () {
+    final r = computeWeeklyMinimumRatio(
+      entries: [
+        _done('2026-06-10'),
+        _done('2026-06-11', vId: 'min'),
+      ],
+      variantsById: variantsById,
+      asOf: DateTime(2026, 6, 11),
+    );
+    expect(r.totalDone, 2);
+    expect(r.minimumUsed, 1);
+    expect(r.ratio, 0.5);
+  });
+}