feat(ai-partner): compressed profile generator (#1452) by CraigBuckmaster · Pull Request #1480 · CraigBuckmaster/ScriptureDeepDive

CraigBuckmaster · 2026-04-17T07:03:34Z

Closes#1452. Phase 1 of epic #1446.

Summary

New app/src/services/amicus/profile/ generator — deterministic, on-device, caches in user.db.
Migration v15 adds partner_profile_cache (singleton row, id=1).
Profile is user-inspectable via getProfileForInspection() for the forthcoming Settings screen (ai-partner: Settings controls #1459).
clearProfile() wipes the cache (backs the "Clear Amicus History" button).

Signals

Reads only from already-existing tables (or future tables with graceful fallback):

reading_progress — total chapters, last-30-day count, recent chapters, current focus
scholar_opens (future) — top 5 scholars ≥10 opens trigger the scholar clause
scholars + books — tradition + genre distribution via joins on user reads
journey_progress (future) — completed + active journeys

Caching

SHA-256 over sorted-key canonical JSON of the raw signals.
Cache hit when hash matches and generated_at < 7 days old.
force=true bypasses.
Singleton row — never accumulates.

Test plan

Migration v15 appended; existing user DB tests updated (14 → 15)
npx tsc --noEmit — 0 errors
npx jest — 3,199 tests pass (16 new)
Thick profile / thin profile / truncation / 24h window / cache hit / miss / expire / force all covered
hashRawSignals deterministic + key-order-independent
clearProfile DELETE verified
No any types; strict mode passes

Out of scope

New engagement tables (e.g. scholar_opens) — generator degrades to empty for these today
Background auto-refresh — first-use regeneration is enough for v1
Sending the profile to the proxy — consumed by ai-partner: client-side retrieval with sqlite-vec #1451's retrieve()

https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

Deterministic, on-device generator that reads engagement signals from user.db and produces a 100-200-token prose summary. Sent to Amicus on every request; user-inspectable in Settings (#1459). Migration v15 adds partner_profile_cache (singleton, id=1) to user.db. The generator SHA-256-hashes the raw signals and skips regeneration when the hash matches a <7-day-old cached row. New modules under app/src/services/amicus/profile/: - types.ts — RawSignals, CompressedProfile, ProfileForInspection - signals.ts — queries for total_chapters_read, last_30_day, top scholars, tradition + genre distribution, journey state, recent chapters, current focus. Tables that don't exist yet (scholar_opens, journey_progress) degrade gracefully to empty. - templates.ts — prose assembly with six optional sections; thin profiles get a deliberately minimal "new to study" phrasing so Amicus doesn't over-personalize. - generator.ts — generateProfile(force), getProfileForInspection(), clearProfile(), hashRawSignals(). Stable sorted-key canonicalization so identical signals always hash identically. - index.ts — public barrel 16 Jest tests: template section inclusion rules, thick/thin profiles, truncation, 24-hour reading window, cache hit/miss/expire/force, hash determinism and key-order independence, clearProfile DELETE. Also bumps __tests__/{db,unit}/userDatabase.test.ts migration counts from 14 → 15 to match. All 3,199 app tests pass; tsc clean. https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

github-actions · 2026-04-17T07:05:34Z

Test Results

✅ All tests passed

	Passed	Failed	Total
Tests	✅ 3199	❌ 0	3199
Suites	✅ 428	❌ 0	428

Coverage

Statements	Branches	Functions	Lines
—	—	—	—

⏱️ Duration: 72.2s

CraigBuckmaster · 2026-04-17T07:03:34Z

Closes#1452. Phase 1 of epic #1446.

Summary

New app/src/services/amicus/profile/ generator — deterministic, on-device, caches in user.db.
Migration v15 adds partner_profile_cache (singleton row, id=1).
Profile is user-inspectable via getProfileForInspection() for the forthcoming Settings screen (ai-partner: Settings controls #1459).
clearProfile() wipes the cache (backs the "Clear Amicus History" button).

Signals

Reads only from already-existing tables (or future tables with graceful fallback):

reading_progress — total chapters, last-30-day count, recent chapters, current focus
scholar_opens (future) — top 5 scholars ≥10 opens trigger the scholar clause
scholars + books — tradition + genre distribution via joins on user reads
journey_progress (future) — completed + active journeys

Caching

SHA-256 over sorted-key canonical JSON of the raw signals.
Cache hit when hash matches and generated_at < 7 days old.
force=true bypasses.
Singleton row — never accumulates.

Test plan

Migration v15 appended; existing user DB tests updated (14 → 15)
npx tsc --noEmit — 0 errors
npx jest — 3,199 tests pass (16 new)
Thick profile / thin profile / truncation / 24h window / cache hit / miss / expire / force all covered
hashRawSignals deterministic + key-order-independent
clearProfile DELETE verified
No any types; strict mode passes

Out of scope

New engagement tables (e.g. scholar_opens) — generator degrades to empty for these today
Background auto-refresh — first-use regeneration is enough for v1
Sending the profile to the proxy — consumed by ai-partner: client-side retrieval with sqlite-vec #1451's retrieve()

https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

Deterministic, on-device generator that reads engagement signals from user.db and produces a 100-200-token prose summary. Sent to Amicus on every request; user-inspectable in Settings (#1459). Migration v15 adds partner_profile_cache (singleton, id=1) to user.db. The generator SHA-256-hashes the raw signals and skips regeneration when the hash matches a <7-day-old cached row. New modules under app/src/services/amicus/profile/: - types.ts — RawSignals, CompressedProfile, ProfileForInspection - signals.ts — queries for total_chapters_read, last_30_day, top scholars, tradition + genre distribution, journey state, recent chapters, current focus. Tables that don't exist yet (scholar_opens, journey_progress) degrade gracefully to empty. - templates.ts — prose assembly with six optional sections; thin profiles get a deliberately minimal "new to study" phrasing so Amicus doesn't over-personalize. - generator.ts — generateProfile(force), getProfileForInspection(), clearProfile(), hashRawSignals(). Stable sorted-key canonicalization so identical signals always hash identically. - index.ts — public barrel 16 Jest tests: template section inclusion rules, thick/thin profiles, truncation, 24-hour reading window, cache hit/miss/expire/force, hash determinism and key-order independence, clearProfile DELETE. Also bumps __tests__/{db,unit}/userDatabase.test.ts migration counts from 14 → 15 to match. All 3,199 app tests pass; tsc clean. https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

github-actions · 2026-04-17T07:05:34Z

Test Results

✅ All tests passed

	Passed	Failed	Total
Tests	✅ 3199	❌ 0	3199
Suites	✅ 428	❌ 0	428

Coverage

Statements	Branches	Functions	Lines
—	—	—	—

⏱️ Duration: 72.2s

CraigBuckmaster · 2026-04-17T07:03:34Z

Closes#1452. Phase 1 of epic #1446.

Summary

New app/src/services/amicus/profile/ generator — deterministic, on-device, caches in user.db.
Migration v15 adds partner_profile_cache (singleton row, id=1).
Profile is user-inspectable via getProfileForInspection() for the forthcoming Settings screen (ai-partner: Settings controls #1459).
clearProfile() wipes the cache (backs the "Clear Amicus History" button).

Signals

Reads only from already-existing tables (or future tables with graceful fallback):

reading_progress — total chapters, last-30-day count, recent chapters, current focus
scholar_opens (future) — top 5 scholars ≥10 opens trigger the scholar clause
scholars + books — tradition + genre distribution via joins on user reads
journey_progress (future) — completed + active journeys

Caching

SHA-256 over sorted-key canonical JSON of the raw signals.
Cache hit when hash matches and generated_at < 7 days old.
force=true bypasses.
Singleton row — never accumulates.

Test plan

Migration v15 appended; existing user DB tests updated (14 → 15)
npx tsc --noEmit — 0 errors
npx jest — 3,199 tests pass (16 new)
Thick profile / thin profile / truncation / 24h window / cache hit / miss / expire / force all covered
hashRawSignals deterministic + key-order-independent
clearProfile DELETE verified
No any types; strict mode passes

Out of scope

New engagement tables (e.g. scholar_opens) — generator degrades to empty for these today
Background auto-refresh — first-use regeneration is enough for v1
Sending the profile to the proxy — consumed by ai-partner: client-side retrieval with sqlite-vec #1451's retrieve()

https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

Deterministic, on-device generator that reads engagement signals from user.db and produces a 100-200-token prose summary. Sent to Amicus on every request; user-inspectable in Settings (#1459). Migration v15 adds partner_profile_cache (singleton, id=1) to user.db. The generator SHA-256-hashes the raw signals and skips regeneration when the hash matches a <7-day-old cached row. New modules under app/src/services/amicus/profile/: - types.ts — RawSignals, CompressedProfile, ProfileForInspection - signals.ts — queries for total_chapters_read, last_30_day, top scholars, tradition + genre distribution, journey state, recent chapters, current focus. Tables that don't exist yet (scholar_opens, journey_progress) degrade gracefully to empty. - templates.ts — prose assembly with six optional sections; thin profiles get a deliberately minimal "new to study" phrasing so Amicus doesn't over-personalize. - generator.ts — generateProfile(force), getProfileForInspection(), clearProfile(), hashRawSignals(). Stable sorted-key canonicalization so identical signals always hash identically. - index.ts — public barrel 16 Jest tests: template section inclusion rules, thick/thin profiles, truncation, 24-hour reading window, cache hit/miss/expire/force, hash determinism and key-order independence, clearProfile DELETE. Also bumps __tests__/{db,unit}/userDatabase.test.ts migration counts from 14 → 15 to match. All 3,199 app tests pass; tsc clean. https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

github-actions · 2026-04-17T07:05:34Z

Test Results

✅ All tests passed

	Passed	Failed	Total
Tests	✅ 3199	❌ 0	3199
Suites	✅ 428	❌ 0	428

Coverage

Statements	Branches	Functions	Lines
—	—	—	—

⏱️ Duration: 72.2s

CraigBuckmaster · 2026-04-17T07:03:34Z

Closes#1452. Phase 1 of epic #1446.

Summary

New app/src/services/amicus/profile/ generator — deterministic, on-device, caches in user.db.
Migration v15 adds partner_profile_cache (singleton row, id=1).
Profile is user-inspectable via getProfileForInspection() for the forthcoming Settings screen (ai-partner: Settings controls #1459).
clearProfile() wipes the cache (backs the "Clear Amicus History" button).

Signals

Reads only from already-existing tables (or future tables with graceful fallback):

reading_progress — total chapters, last-30-day count, recent chapters, current focus
scholar_opens (future) — top 5 scholars ≥10 opens trigger the scholar clause
scholars + books — tradition + genre distribution via joins on user reads
journey_progress (future) — completed + active journeys

Caching

SHA-256 over sorted-key canonical JSON of the raw signals.
Cache hit when hash matches and generated_at < 7 days old.
force=true bypasses.
Singleton row — never accumulates.

Test plan

Migration v15 appended; existing user DB tests updated (14 → 15)
npx tsc --noEmit — 0 errors
npx jest — 3,199 tests pass (16 new)
Thick profile / thin profile / truncation / 24h window / cache hit / miss / expire / force all covered
hashRawSignals deterministic + key-order-independent
clearProfile DELETE verified
No any types; strict mode passes

Out of scope

New engagement tables (e.g. scholar_opens) — generator degrades to empty for these today
Background auto-refresh — first-use regeneration is enough for v1
Sending the profile to the proxy — consumed by ai-partner: client-side retrieval with sqlite-vec #1451's retrieve()

https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

Deterministic, on-device generator that reads engagement signals from user.db and produces a 100-200-token prose summary. Sent to Amicus on every request; user-inspectable in Settings (#1459). Migration v15 adds partner_profile_cache (singleton, id=1) to user.db. The generator SHA-256-hashes the raw signals and skips regeneration when the hash matches a <7-day-old cached row. New modules under app/src/services/amicus/profile/: - types.ts — RawSignals, CompressedProfile, ProfileForInspection - signals.ts — queries for total_chapters_read, last_30_day, top scholars, tradition + genre distribution, journey state, recent chapters, current focus. Tables that don't exist yet (scholar_opens, journey_progress) degrade gracefully to empty. - templates.ts — prose assembly with six optional sections; thin profiles get a deliberately minimal "new to study" phrasing so Amicus doesn't over-personalize. - generator.ts — generateProfile(force), getProfileForInspection(), clearProfile(), hashRawSignals(). Stable sorted-key canonicalization so identical signals always hash identically. - index.ts — public barrel 16 Jest tests: template section inclusion rules, thick/thin profiles, truncation, 24-hour reading window, cache hit/miss/expire/force, hash determinism and key-order independence, clearProfile DELETE. Also bumps __tests__/{db,unit}/userDatabase.test.ts migration counts from 14 → 15 to match. All 3,199 app tests pass; tsc clean. https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

github-actions · 2026-04-17T07:05:34Z

Test Results

✅ All tests passed

	Passed	Failed	Total
Tests	✅ 3199	❌ 0	3199
Suites	✅ 428	❌ 0	428

Coverage

Statements	Branches	Functions	Lines
—	—	—	—

⏱️ Duration: 72.2s

CraigBuckmaster · 2026-04-17T07:03:34Z

Closes#1452. Phase 1 of epic #1446.

Summary

New app/src/services/amicus/profile/ generator — deterministic, on-device, caches in user.db.
Migration v15 adds partner_profile_cache (singleton row, id=1).
Profile is user-inspectable via getProfileForInspection() for the forthcoming Settings screen (ai-partner: Settings controls #1459).
clearProfile() wipes the cache (backs the "Clear Amicus History" button).

Signals

Reads only from already-existing tables (or future tables with graceful fallback):

reading_progress — total chapters, last-30-day count, recent chapters, current focus
scholar_opens (future) — top 5 scholars ≥10 opens trigger the scholar clause
scholars + books — tradition + genre distribution via joins on user reads
journey_progress (future) — completed + active journeys

Caching

SHA-256 over sorted-key canonical JSON of the raw signals.
Cache hit when hash matches and generated_at < 7 days old.
force=true bypasses.
Singleton row — never accumulates.

Test plan

Migration v15 appended; existing user DB tests updated (14 → 15)
npx tsc --noEmit — 0 errors
npx jest — 3,199 tests pass (16 new)
Thick profile / thin profile / truncation / 24h window / cache hit / miss / expire / force all covered
hashRawSignals deterministic + key-order-independent
clearProfile DELETE verified
No any types; strict mode passes

Out of scope

New engagement tables (e.g. scholar_opens) — generator degrades to empty for these today
Background auto-refresh — first-use regeneration is enough for v1
Sending the profile to the proxy — consumed by ai-partner: client-side retrieval with sqlite-vec #1451's retrieve()

https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

Deterministic, on-device generator that reads engagement signals from user.db and produces a 100-200-token prose summary. Sent to Amicus on every request; user-inspectable in Settings (#1459). Migration v15 adds partner_profile_cache (singleton, id=1) to user.db. The generator SHA-256-hashes the raw signals and skips regeneration when the hash matches a <7-day-old cached row. New modules under app/src/services/amicus/profile/: - types.ts — RawSignals, CompressedProfile, ProfileForInspection - signals.ts — queries for total_chapters_read, last_30_day, top scholars, tradition + genre distribution, journey state, recent chapters, current focus. Tables that don't exist yet (scholar_opens, journey_progress) degrade gracefully to empty. - templates.ts — prose assembly with six optional sections; thin profiles get a deliberately minimal "new to study" phrasing so Amicus doesn't over-personalize. - generator.ts — generateProfile(force), getProfileForInspection(), clearProfile(), hashRawSignals(). Stable sorted-key canonicalization so identical signals always hash identically. - index.ts — public barrel 16 Jest tests: template section inclusion rules, thick/thin profiles, truncation, 24-hour reading window, cache hit/miss/expire/force, hash determinism and key-order independence, clearProfile DELETE. Also bumps __tests__/{db,unit}/userDatabase.test.ts migration counts from 14 → 15 to match. All 3,199 app tests pass; tsc clean. https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

github-actions · 2026-04-17T07:05:34Z

Test Results

✅ All tests passed

	Passed	Failed	Total
Tests	✅ 3199	❌ 0	3199
Suites	✅ 428	❌ 0	428

Coverage

Statements	Branches	Functions	Lines
—	—	—	—

⏱️ Duration: 72.2s

CraigBuckmaster · 2026-04-17T07:03:34Z

Closes#1452. Phase 1 of epic #1446.

Summary

New app/src/services/amicus/profile/ generator — deterministic, on-device, caches in user.db.
Migration v15 adds partner_profile_cache (singleton row, id=1).
Profile is user-inspectable via getProfileForInspection() for the forthcoming Settings screen (ai-partner: Settings controls #1459).
clearProfile() wipes the cache (backs the "Clear Amicus History" button).

Signals

Reads only from already-existing tables (or future tables with graceful fallback):

reading_progress — total chapters, last-30-day count, recent chapters, current focus
scholar_opens (future) — top 5 scholars ≥10 opens trigger the scholar clause
scholars + books — tradition + genre distribution via joins on user reads
journey_progress (future) — completed + active journeys

Caching

SHA-256 over sorted-key canonical JSON of the raw signals.
Cache hit when hash matches and generated_at < 7 days old.
force=true bypasses.
Singleton row — never accumulates.

Test plan

Migration v15 appended; existing user DB tests updated (14 → 15)
npx tsc --noEmit — 0 errors
npx jest — 3,199 tests pass (16 new)
Thick profile / thin profile / truncation / 24h window / cache hit / miss / expire / force all covered
hashRawSignals deterministic + key-order-independent
clearProfile DELETE verified
No any types; strict mode passes

Out of scope

New engagement tables (e.g. scholar_opens) — generator degrades to empty for these today
Background auto-refresh — first-use regeneration is enough for v1
Sending the profile to the proxy — consumed by ai-partner: client-side retrieval with sqlite-vec #1451's retrieve()

https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

Deterministic, on-device generator that reads engagement signals from user.db and produces a 100-200-token prose summary. Sent to Amicus on every request; user-inspectable in Settings (#1459). Migration v15 adds partner_profile_cache (singleton, id=1) to user.db. The generator SHA-256-hashes the raw signals and skips regeneration when the hash matches a <7-day-old cached row. New modules under app/src/services/amicus/profile/: - types.ts — RawSignals, CompressedProfile, ProfileForInspection - signals.ts — queries for total_chapters_read, last_30_day, top scholars, tradition + genre distribution, journey state, recent chapters, current focus. Tables that don't exist yet (scholar_opens, journey_progress) degrade gracefully to empty. - templates.ts — prose assembly with six optional sections; thin profiles get a deliberately minimal "new to study" phrasing so Amicus doesn't over-personalize. - generator.ts — generateProfile(force), getProfileForInspection(), clearProfile(), hashRawSignals(). Stable sorted-key canonicalization so identical signals always hash identically. - index.ts — public barrel 16 Jest tests: template section inclusion rules, thick/thin profiles, truncation, 24-hour reading window, cache hit/miss/expire/force, hash determinism and key-order independence, clearProfile DELETE. Also bumps __tests__/{db,unit}/userDatabase.test.ts migration counts from 14 → 15 to match. All 3,199 app tests pass; tsc clean. https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

github-actions · 2026-04-17T07:05:34Z

Test Results

✅ All tests passed

	Passed	Failed	Total
Tests	✅ 3199	❌ 0	3199
Suites	✅ 428	❌ 0	428

Coverage

Statements	Branches	Functions	Lines
—	—	—	—

⏱️ Duration: 72.2s

CraigBuckmaster · 2026-04-17T07:03:34Z

Closes#1452. Phase 1 of epic #1446.

Summary

New app/src/services/amicus/profile/ generator — deterministic, on-device, caches in user.db.
Migration v15 adds partner_profile_cache (singleton row, id=1).
Profile is user-inspectable via getProfileForInspection() for the forthcoming Settings screen (ai-partner: Settings controls #1459).
clearProfile() wipes the cache (backs the "Clear Amicus History" button).

Signals

Reads only from already-existing tables (or future tables with graceful fallback):

reading_progress — total chapters, last-30-day count, recent chapters, current focus
scholar_opens (future) — top 5 scholars ≥10 opens trigger the scholar clause
scholars + books — tradition + genre distribution via joins on user reads
journey_progress (future) — completed + active journeys

Caching

SHA-256 over sorted-key canonical JSON of the raw signals.
Cache hit when hash matches and generated_at < 7 days old.
force=true bypasses.
Singleton row — never accumulates.

Test plan

Migration v15 appended; existing user DB tests updated (14 → 15)
npx tsc --noEmit — 0 errors
npx jest — 3,199 tests pass (16 new)
Thick profile / thin profile / truncation / 24h window / cache hit / miss / expire / force all covered
hashRawSignals deterministic + key-order-independent
clearProfile DELETE verified
No any types; strict mode passes

Out of scope

New engagement tables (e.g. scholar_opens) — generator degrades to empty for these today
Background auto-refresh — first-use regeneration is enough for v1
Sending the profile to the proxy — consumed by ai-partner: client-side retrieval with sqlite-vec #1451's retrieve()

https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

Deterministic, on-device generator that reads engagement signals from user.db and produces a 100-200-token prose summary. Sent to Amicus on every request; user-inspectable in Settings (#1459). Migration v15 adds partner_profile_cache (singleton, id=1) to user.db. The generator SHA-256-hashes the raw signals and skips regeneration when the hash matches a <7-day-old cached row. New modules under app/src/services/amicus/profile/: - types.ts — RawSignals, CompressedProfile, ProfileForInspection - signals.ts — queries for total_chapters_read, last_30_day, top scholars, tradition + genre distribution, journey state, recent chapters, current focus. Tables that don't exist yet (scholar_opens, journey_progress) degrade gracefully to empty. - templates.ts — prose assembly with six optional sections; thin profiles get a deliberately minimal "new to study" phrasing so Amicus doesn't over-personalize. - generator.ts — generateProfile(force), getProfileForInspection(), clearProfile(), hashRawSignals(). Stable sorted-key canonicalization so identical signals always hash identically. - index.ts — public barrel 16 Jest tests: template section inclusion rules, thick/thin profiles, truncation, 24-hour reading window, cache hit/miss/expire/force, hash determinism and key-order independence, clearProfile DELETE. Also bumps __tests__/{db,unit}/userDatabase.test.ts migration counts from 14 → 15 to match. All 3,199 app tests pass; tsc clean. https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

github-actions · 2026-04-17T07:05:34Z

Test Results

✅ All tests passed

	Passed	Failed	Total
Tests	✅ 3199	❌ 0	3199
Suites	✅ 428	❌ 0	428

Coverage

Statements	Branches	Functions	Lines
—	—	—	—

⏱️ Duration: 72.2s

CraigBuckmaster · 2026-04-17T07:03:34Z

Closes#1452. Phase 1 of epic #1446.

Summary

New app/src/services/amicus/profile/ generator — deterministic, on-device, caches in user.db.
Migration v15 adds partner_profile_cache (singleton row, id=1).
Profile is user-inspectable via getProfileForInspection() for the forthcoming Settings screen (ai-partner: Settings controls #1459).
clearProfile() wipes the cache (backs the "Clear Amicus History" button).

Signals

Reads only from already-existing tables (or future tables with graceful fallback):

reading_progress — total chapters, last-30-day count, recent chapters, current focus
scholar_opens (future) — top 5 scholars ≥10 opens trigger the scholar clause
scholars + books — tradition + genre distribution via joins on user reads
journey_progress (future) — completed + active journeys

Caching

SHA-256 over sorted-key canonical JSON of the raw signals.
Cache hit when hash matches and generated_at < 7 days old.
force=true bypasses.
Singleton row — never accumulates.

Test plan

Migration v15 appended; existing user DB tests updated (14 → 15)
npx tsc --noEmit — 0 errors
npx jest — 3,199 tests pass (16 new)
Thick profile / thin profile / truncation / 24h window / cache hit / miss / expire / force all covered
hashRawSignals deterministic + key-order-independent
clearProfile DELETE verified
No any types; strict mode passes

Out of scope

New engagement tables (e.g. scholar_opens) — generator degrades to empty for these today
Background auto-refresh — first-use regeneration is enough for v1
Sending the profile to the proxy — consumed by ai-partner: client-side retrieval with sqlite-vec #1451's retrieve()

https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

Deterministic, on-device generator that reads engagement signals from user.db and produces a 100-200-token prose summary. Sent to Amicus on every request; user-inspectable in Settings (#1459). Migration v15 adds partner_profile_cache (singleton, id=1) to user.db. The generator SHA-256-hashes the raw signals and skips regeneration when the hash matches a <7-day-old cached row. New modules under app/src/services/amicus/profile/: - types.ts — RawSignals, CompressedProfile, ProfileForInspection - signals.ts — queries for total_chapters_read, last_30_day, top scholars, tradition + genre distribution, journey state, recent chapters, current focus. Tables that don't exist yet (scholar_opens, journey_progress) degrade gracefully to empty. - templates.ts — prose assembly with six optional sections; thin profiles get a deliberately minimal "new to study" phrasing so Amicus doesn't over-personalize. - generator.ts — generateProfile(force), getProfileForInspection(), clearProfile(), hashRawSignals(). Stable sorted-key canonicalization so identical signals always hash identically. - index.ts — public barrel 16 Jest tests: template section inclusion rules, thick/thin profiles, truncation, 24-hour reading window, cache hit/miss/expire/force, hash determinism and key-order independence, clearProfile DELETE. Also bumps __tests__/{db,unit}/userDatabase.test.ts migration counts from 14 → 15 to match. All 3,199 app tests pass; tsc clean. https://claude.ai/code/session_01Pht3kzgdvkn81DDfL9SnFe

github-actions · 2026-04-17T07:05:34Z

Test Results

✅ All tests passed

	Passed	Failed	Total
Tests	✅ 3199	❌ 0	3199
Suites	✅ 428	❌ 0	428