Add Endor source reader before lexing with provenance and URI provider

crates/cli/src/README.md

@@ -1,7 +1,7 @@
 # CLI 入口
 
-[main.rs](main.rs) 是唯一入口：同步 main 将 run 的结果转成进程退出码；run 处理 bootstrap、parse 文件、help、文件 metadata put/get/import，错误打印到 stderr 并返回失败。
+[main.rs](main.rs) 是唯一入口：同步 main 将 run 的结果转成进程退出码；run 处理 bootstrap、parse 文件／stdin、help、文件 metadata put/get/import，错误打印到 stderr 并返回失败。
 
-bootstrap 创建并显式释放两个对象，不读取数据库环境、不打开数据库。parse 使用 frontend 输出 AST，词法／语法错误显示文件、行、列；不创建 VM 或执行源码。未知命令报错；metadata 通过 host::MetadataStore 读写文件，import 从标准输入接收旧记录且不覆盖已有文件。参数目前由 std::env::args 读取，非 Unicode 参数可能 panic，边界见 [配置](../../../docs/operations/configuration.md)。
+bootstrap 创建并显式释放两个对象，不读取数据库环境、不打开数据库。parse 使用 EndorReader 和 parse_source 输出 AST；`-` 从 stdin 读到 EOF，来源为 `<stdin>`。词法／语法错误显示来源、行、列；不创建 VM 或执行源码。未知命令报错；metadata 通过 host::MetadataStore 读写文件，import 从标准输入接收旧记录且不覆盖已有文件。参数目前由 std::env::args 读取，非 Unicode 参数可能 panic，边界见 [配置](../../../docs/operations/configuration.md)。
 
 新增命令时更新用法、[运行指南](../../../docs/operations/README.md) 和 [smoke.py 的导航](../../../scripts/README.md)。返回 [cli](../README.md)。

crates/cli/src/main.rs

@@ -2,9 +2,10 @@ use std::error::Error;
 use std::process::ExitCode;
 
 use endor_core::{Value, Vm};
+use frontend::{EndorReader, parse_source};
 use host::MetadataStore;
 
-const USAGE: &str = "Usage: cli [bootstrap | parse <file> | metadata put <key> <value> | metadata get <key> | metadata import | help]";
+const USAGE: &str = "Usage: cli [bootstrap | parse <file|-> | metadata put <key> <value> | metadata get <key> | metadata import | help]";
 
 fn main() -> ExitCode {
     match run() {
@@ -46,15 +47,12 @@ fn run() -> Result<(), Box<dyn Error>> {
         }
         ["help"] | ["--help"] | ["-h"] => println!("{USAGE}"),
         ["parse", path] => {
-            let source =
-                std::fs::read_to_string(path).map_err(|error| format!("{path}: {error}"))?;
-            let program = frontend::parse(&source).map_err(|error| {
-                let location = error.location(&source);
-                format!(
-                    "{path}:{}:{}: {}",
-                    location.line, location.column, error.message
-                )
-            })?;
+            let source = if *path == "-" {
+                EndorReader::from_stream("<stdin>", std::io::stdin().lock())?
+            } else {
+                EndorReader::from_file(path)?
+            };
+            let program = parse_source(&source)?;
             println!("{program:#?}");
         }
         ["metadata", "put", key, value] => {