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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
//! Project identity shared by public API responses and adapters.
/// Canonical package and product name used in user-facing output.
pub const PROJECT_NAME: &str = "relay-knowledge";
/// Canonical application directory name used in platform runtime paths.
pub const APP_DIR_NAME: &str = PROJECT_NAME;
/// Default SQLite database filename stored under the resolved data directory.
pub const DATABASE_FILE_NAME: &str = "relay-knowledge.sqlite";
/// Directory under the data directory that stores pluggable storage backends.
pub const STORAGE_BACKENDS_DIR_NAME: &str = "stores";
/// Directory under the storage backends directory that stores repository shards.
pub const REPOSITORY_SHARDS_DIR_NAME: &str = "repositories";
/// SQLite filename used by each partitioned repository shard.
pub const REPOSITORY_SHARD_DATABASE_FILE_NAME: &str = "code.sqlite";
/// Model provider profile configuration filename stored under the config directory.
pub const MODEL_PROFILES_FILE_NAME: &str = "model-profiles.json";
/// Model provider fallback policy filename stored under the config directory.
pub const MODEL_FALLBACK_FILE_NAME: &str = "model-fallback.json";
/// Model catalog cache filename stored under the cache directory.
pub const MODEL_CATALOG_CACHE_FILE_NAME: &str = "model-catalog-cache.json";
/// Repository-relative directory that stores shared agent contracts.
pub const AGENT_CONTRACT_DIR_NAME: &str = "knowledge";
/// Legacy repository contract directory accepted by v3 migration readers.
pub const LEGACY_AGENT_CONTRACT_DIR_NAME: &str = ".knowledge";
/// Repository-relative CodeSpec governance directory.
pub const CODESPEC_DIR_NAME: &str = "codespec";
/// Repository-relative knowledge navigation contract filename.
pub const KNOWLEDGE_MAP_FILE_NAME: &str = "knowledge-map.yaml";
/// Repository-relative knowledge navigation contract path referenced by agents.
pub const KNOWLEDGE_MAP_RELATIVE_PATH: &str = "knowledge/knowledge-map.yaml";
/// Legacy Knowledge Map root used by v1/v2 readers and v3 redirects.
pub const LEGACY_KNOWLEDGE_MAP_RELATIVE_PATH: &str = ".knowledge/knowledge-map.yaml";
/// Retained v1/v2 Knowledge Map root used to preflight and execute v3 rollback.
pub const LEGACY_KNOWLEDGE_MAP_BACKUP_FILE_NAME: &str = "knowledge-map.v2.yaml";
/// Previous legacy Knowledge Map root retained by v1/v2 manifest publication.
pub const LEGACY_KNOWLEDGE_MAP_PREVIOUS_FILE_NAME: &str = "knowledge-map.yaml.previous";
/// Retained visible v3 Knowledge Map root kept after a rollback.
pub const KNOWLEDGE_MAP_V3_RETAINED_FILE_NAME: &str = "knowledge-map.yaml.v3.previous";
/// Retained ordinary publication backup kept outside the visible reader fallback after rollback.
pub const KNOWLEDGE_MAP_V3_RETAINED_BACKUP_FILE_NAME: &str =
"knowledge-map.yaml.v3.previous.backup";
/// Staged legacy redirect used by the recoverable v3 publication protocol.
pub const LEGACY_KNOWLEDGE_MAP_REDIRECT_PREPARED_FILE_NAME: &str =
"knowledge-map.yaml.redirect.prepared";
/// Previous legacy root used by the recoverable v3 redirect publication protocol.
pub const LEGACY_KNOWLEDGE_MAP_REDIRECT_PREVIOUS_FILE_NAME: &str =
"knowledge-map.yaml.redirect.previous";
/// Staged retained root used by the no-follow v3 rollback publication protocol.
pub const LEGACY_KNOWLEDGE_MAP_ROLLBACK_PREPARED_FILE_NAME: &str =
"knowledge-map.yaml.rollback.prepared";
/// Previous legacy live root used while atomically publishing a v3 rollback.
pub const LEGACY_KNOWLEDGE_MAP_ROLLBACK_PREVIOUS_FILE_NAME: &str =
"knowledge-map.yaml.rollback.previous";
/// Repository-relative CodeSpec navigation contract filename.
pub const CODESPEC_MAP_FILE_NAME: &str = "codespec-map.yaml";
/// Repository-relative CodeSpec navigation contract path.
pub const CODESPEC_MAP_RELATIVE_PATH: &str = "codespec/codespec-map.yaml";
/// Repository-relative authored business glossary filename.
pub const BUSINESS_GLOSSARY_FILE_NAME: &str = "business-glossary.yaml";
/// Repository-relative authored business glossary path.
pub const BUSINESS_GLOSSARY_RELATIVE_PATH: &str = crateBUSINESS_GLOSSARY_RELATIVE_PATH;
/// Legacy authored glossary path accepted during v3 migration.
pub const LEGACY_BUSINESS_GLOSSARY_RELATIVE_PATH: &str =
crateLEGACY_BUSINESS_GLOSSARY_RELATIVE_PATH;
/// Repository-local directory containing content-addressed Knowledge Map topic shards.
pub const KNOWLEDGE_MAP_TOPICS_DIR_NAME: &str = "topics";
/// Repository-relative prefix containing content-addressed Knowledge Map topic shards.
pub const KNOWLEDGE_MAP_TOPICS_RELATIVE_PREFIX: &str = "knowledge/topics/";
/// Legacy repository-local directory recognized only for bounded migration cleanup.
pub const KNOWLEDGE_MAP_HISTORY_DIR_NAME: &str = "history";
/// Version-check cache filename stored under the cache directory.
pub const VERSION_CHECK_CACHE_FILE_NAME: &str = "version-check-cache.json";
/// Default GitHub repository queried for release metadata.
pub const GITHUB_REPOSITORY_FULL_NAME: &str = "coolplayagent/relay-knowledge";
/// Windows service definition filename for installed background operation.
pub const WINDOWS_SERVICE_DEFINITION_FILE_NAME: &str = "relay-knowledge-service.xml";
/// macOS launchd service definition filename for installed background operation.
pub const MACOS_SERVICE_DEFINITION_FILE_NAME: &str = "com.coolplayagent.relay-knowledge.plist";
/// Linux systemd service definition filename for installed background operation.
pub const LINUX_SERVICE_DEFINITION_FILE_NAME: &str = "relay-knowledge.service";
/// Lifecycle checkpoint filename stored beside generated service definitions.
pub const SERVICE_LIFECYCLE_CHECKPOINT_FILE_NAME: &str = "relay-knowledge-service-lifecycle.json";
/// Resident MCP adapter identity reported in unified API metadata.
pub const MCP_ADAPTER_NAME: &str = "relay-knowledge-mcp";
/// Local ACP adapter identity reported in unified API metadata.
pub const ACP_LOCAL_ADAPTER_NAME: &str = "relay-knowledge-acp-local";