Use remote schema URL for config outputs

- Add SCHEMA_URL constant in config.rs to hold the remote schema URL
- Emit a schema header for TOML and YAML outputs using SCHEMA_URL
- Inject a $schema property into JSON output
- Default to TOML when the file extension is unknown
- Update .peas.toml to reference the remote schema URL
- Extend schemas/peas.json with a $schema field description
- Update README to document automatic in-file directives and URL

Author: asaaki

.peas.toml

@@ -1,4 +1,4 @@
-#:schema ./schemas/peas.json
+#:schema https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json
 
 [peas]
 path = ".peas"

README.md

@@ -228,34 +228,54 @@ use_type_emojis = false # Enable emoji icons for ticket types in TUI
 
 ### Editor Support (JSON Schema)
 
-A JSON Schema is available at `schemas/peas.json` for editor autocompletion and validation.
+A JSON Schema is available for editor autocompletion and validation. New projects created with `peas init` automatically include the schema directive.
 
-**In-file directive (works with Taplo and Tombi):**
+**Schema URL:** `https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json`
 
-Add this comment at the top of your `.peas.toml`:
+**In-file directives (automatically added by `peas init`):**
+
+TOML (Taplo/Tombi):
 ```toml
-#:schema ./schemas/peas.json
+#:schema https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json
 
 [peas]
 prefix = "peas-"
 ```
 
+YAML (yaml-language-server):
+```yaml
+# yaml-language-server: $schema=https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json
+
+peas:
+  prefix: "peas-"
+```
+
+JSON:
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json",
+  "peas": {
+    "prefix": "peas-"
+  }
+}
+```
+
 **Zed with Tombi extension:**
 
-Add to your `tombi.toml` (or project settings):
+The in-file directive works automatically. Alternatively, add to your `tombi.toml`:
 ```toml
 [[schemas]]
-path = "./schemas/peas.json"
+url = "https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json"
 include = [".peas.toml"]
 ```
 
 **VS Code with Even Better TOML (Taplo):**
 
-Add to your `.vscode/settings.json`:
+The in-file directive works automatically. Alternatively, add to `.vscode/settings.json`:
 ```json
 {
   "evenBetterToml.schema.associations": {
-    ".peas.toml": "./schemas/peas.json"
+    ".peas.toml": "https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json"
   }
 }
 ```
@@ -264,15 +284,11 @@ Add to your `.vscode/settings.json`:
 ```json
 {
   "yaml.schemas": {
-    "./schemas/peas.json": [".peas.yml", ".peas.yaml"]
+    "https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json": [".peas.yml", ".peas.yaml"]
   }
 }
 ```
 
-**Neovim with taplo/yaml-language-server:**
-
-Configure your LSP to associate the schema with `.peas.*` files.
-
 ## File Format
 
 Peas are stored as markdown files with TOML frontmatter (YAML and JSON also supported):

schemas/peas.json

@@ -6,6 +6,11 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema URL for editor support",
+      "format": "uri"
+    },
     "peas": {
       "type": "object",
       "description": "Core peas settings",

src/config.rs

@@ -3,6 +3,10 @@ use crate::storage::FrontmatterFormat;
 use serde::{Deserialize, Serialize};
 use std::path::{Path, PathBuf};
 
+/// URL to the JSON Schema for peas configuration files
+pub const SCHEMA_URL: &str =
+    "https://raw.githubusercontent.com/asaaki/peas/refs/heads/main/schemas/peas.json";
+
 /// ID generation mode for tickets
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]
 #[serde(rename_all = "lowercase")]
@@ -163,13 +167,36 @@ impl PeasConfig {
         // Determine format based on file extension, default to TOML
         let content = if let Some(ext) = path.extension().and_then(|s| s.to_str()) {
             match ext {
-                "toml" => toml::to_string_pretty(self)?,
-                "json" => serde_json::to_string_pretty(self)?,
-                "yml" | "yaml" => serde_yaml::to_string(self)?,
-                _ => toml::to_string_pretty(self)?, // Default to TOML
+                "toml" => {
+                    let toml_content = toml::to_string_pretty(self)?;
+                    format!("#:schema {}\n\n{}", SCHEMA_URL, toml_content)
+                }
+                "json" => {
+                    // Add $schema property to JSON output
+                    let mut json_value = serde_json::to_value(self)?;
+                    if let serde_json::Value::Object(ref mut map) = json_value {
+                        map.insert(
+                            "$schema".to_string(),
+                            serde_json::Value::String(SCHEMA_URL.to_string()),
+                        );
+                    }
+                    serde_json::to_string_pretty(&json_value)?
+                }
+                "yml" | "yaml" => {
+                    let yaml_content = serde_yaml::to_string(self)?;
+                    format!(
+                        "# yaml-language-server: $schema={}\n\n{}",
+                        SCHEMA_URL, yaml_content
+                    )
+                }
+                _ => {
+                    let toml_content = toml::to_string_pretty(self)?;
+                    format!("#:schema {}\n\n{}", SCHEMA_URL, toml_content)
+                }
             }
         } else {
-            toml::to_string_pretty(self)? // Default to TOML
+            let toml_content = toml::to_string_pretty(self)?;
+            format!("#:schema {}\n\n{}", SCHEMA_URL, toml_content)
         };
         std::fs::write(path, content)?;
         Ok(())