feat(config): default the schema version when omitted

README.md

@@ -399,7 +399,7 @@ Phora reads `phora.toml` from the working directory, optionally overlaid by
 [`phora.example.toml`](phora.example.toml) for a complete example.
 
 ```toml
-version = 1
+# version = 1             # optional; 1 is the only schema version and the default
 # protocol = "ssh"         # global default for forge sources (default https)
 
 # [defaults]

phora.example.toml

@@ -1,4 +1,4 @@
-version = 1
+# version = 1              # optional; 1 is the only schema version and the default
 
 # protocol selects https vs ssh for host-aliased sources; default https.
 # Uncomment to flip the global default (still overridable per source):

src/config/mod.rs

@@ -57,9 +57,17 @@ impl Defaults {
     }
 }
 
+/// The only schema version phora speaks; omitting `version` selects it.
+pub const SCHEMA_VERSION: u32 = 1;
+
+const fn default_schema_version() -> u32 {
+    SCHEMA_VERSION
+}
+
 #[derive(Debug, Clone, Deserialize)]
 #[serde(deny_unknown_fields)]
 pub struct Config {
+    #[serde(default = "default_schema_version")]
     pub version: u32,
     #[serde(default)]
     pub protocol: Option<Protocol>,

src/config/tests.rs

@@ -323,6 +323,14 @@ fn parses_version_and_all_sections_from_example() {
     assert_eq!(cfg.targets.len(), 3);
 }
 
+#[test]
+fn omitted_version_defaults_to_the_schema_version() {
+    let cfg = Config::parse("[sources.dots]\ngit = \"https://example.com/dots.git\"\n")
+        .expect("a config without a version key should parse");
+    assert_eq!(cfg.version, crate::config::SCHEMA_VERSION);
+    assert_eq!(cfg.sources.len(), 1);
+}
+
 #[test]
 fn parses_source_fields_from_example() {
     let cfg = Config::parse(EXAMPLE_TOML).expect("example toml should parse");

tests/doc_invariants.rs

@@ -153,11 +153,16 @@ fn local_example_toml_drops_legacy_binding_forms() {
 fn readme_self_contained_fences_parse_and_validate() {
     let complete: Vec<String> = fenced_blocks(README)
         .into_iter()
-        .filter(|block| block.trim_start().starts_with("version = 1"))
+        .filter(|block| {
+            let lines: Vec<&str> = block.lines().collect();
+            lines.iter().any(|line| line.starts_with("[sources."))
+                && lines.iter().any(|line| line.starts_with("[targets."))
+        })
         .collect();
     assert!(
         !complete.is_empty(),
-        "README.md: expected at least one self-contained `version = 1` config fence"
+        "README.md: expected at least one self-contained config fence declaring both \
+         a [sources.<s>] and a [targets.<t>] table"
     );
     for block in &complete {
         let config = Config::parse(block).unwrap_or_else(|err| {