mur-common 2.20.7

Shared types and traits for the MUR ecosystem
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

//! Embedded voice templates with locale lookup chain.
//!
//! The (relationship × locale) matrix lives in `templates/`. Lookup falls
//! back from exact match → language-only match → `en-US` (always present).
//! See spec §4.3 for the full strategy.

use crate::companion::Relationship;

/// Returns the embedded template body for the (relationship, locale) pair, or
/// `None` if the exact pair is not embedded. Use [`resolve_locale`] for the
/// fallback-aware lookup.
pub fn embedded(relationship: &Relationship, locale: &str) -> Option<&'static str> {
    match (relationship, locale) {
        (Relationship::Friend, "zh-TW") => Some(include_str!("templates/friend.zh-TW.md")),
        (Relationship::Friend, "en-US") => Some(include_str!("templates/friend.en-US.md")),
        (Relationship::Friend, "zh-CN") => Some(include_str!("templates/friend.zh-CN.md")),
        (Relationship::Friend, "ja-JP") => Some(include_str!("templates/friend.ja-JP.md")),
        (Relationship::Coach, "zh-TW") => Some(include_str!("templates/coach.zh-TW.md")),
        (Relationship::Coach, "en-US") => Some(include_str!("templates/coach.en-US.md")),
        (Relationship::AccountabilityBuddy, "zh-TW") => {
            Some(include_str!("templates/accountability_buddy.zh-TW.md"))
        }
        (Relationship::AccountabilityBuddy, "en-US") => {
            Some(include_str!("templates/accountability_buddy.en-US.md"))
        }
        (Relationship::Mentor, "zh-TW") => Some(include_str!("templates/mentor.zh-TW.md")),
        (Relationship::Mentor, "en-US") => Some(include_str!("templates/mentor.en-US.md")),
        _ => None,
    }
}

/// Returns every (relationship, locale, body) triple that is embedded.
/// Used by `mur agent companion templates eject` to write all templates to disk.
pub fn all_templates() -> Vec<(Relationship, &'static str, &'static str)> {
    use Relationship::*;
    vec![
        (Friend, "zh-TW", include_str!("templates/friend.zh-TW.md")),
        (Friend, "en-US", include_str!("templates/friend.en-US.md")),
        (Friend, "zh-CN", include_str!("templates/friend.zh-CN.md")),
        (Friend, "ja-JP", include_str!("templates/friend.ja-JP.md")),
        (Coach, "zh-TW", include_str!("templates/coach.zh-TW.md")),
        (Coach, "en-US", include_str!("templates/coach.en-US.md")),
        (
            AccountabilityBuddy,
            "zh-TW",
            include_str!("templates/accountability_buddy.zh-TW.md"),
        ),
        (
            AccountabilityBuddy,
            "en-US",
            include_str!("templates/accountability_buddy.en-US.md"),
        ),
        (Mentor, "zh-TW", include_str!("templates/mentor.zh-TW.md")),
        (Mentor, "en-US", include_str!("templates/mentor.en-US.md")),
    ]
}

/// Locale fallback chain: exact → language-only → en-US.
/// Returns (locale_actually_used, template_body).
pub fn resolve_locale(relationship: &Relationship, locale: &str) -> (String, &'static str) {
    if let Some(t) = embedded(relationship, locale) {
        return (locale.into(), t);
    }
    let lang = locale.split('-').next().unwrap_or(locale);
    if locale != lang
        && let Some(t) = embedded(relationship, lang)
    {
        return (lang.into(), t);
    }
    let t =
        embedded(relationship, "en-US").expect("en-US template must exist for every relationship");
    ("en-US".into(), t)
}