M3.7: lutra CLI and single instance

- crates/control: rendezvous file (<data_dir>/instance.json, port + random
  token, atomic write, 0600 on Unix, stale detection), token-protected
  listener (start_with_token, app.auth first, constant-time compare,
  10 s auth timeout), app.focus, and a blocking client (connect_live,
  request/execute/subscribe/next_event, open_folder/open_file/reveal)
- lutra-desktop: a normal start forwards its path to a running instance
  and exits, otherwise claims the rendezvous; --control instances skip it
  unless LUTRA_RENDEZVOUS_DIR is set; non-Unicode args are usage errors
- lutra-cli (binary lutra, now L6): path[:line[:column]] targets, folder ->
  project.open, file -> file.open (parent opened without a project, outside
  the project refused), editor.reveal, starts the desktop if needed,
  --wait until bufferClosed, --version/--help, exit codes 0/1/2
- tests: proptest target parsing, rendezvous read/write/stale, token check
  over TCP, forwarding against a test backend, --wait end to end
- docs: architecture, G7, ROADMAP (agent automation 18% est.), roadmap,
  README

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-10-18 00:23:09 +02:00
parent 9ccfc1bf6a
commit 9b278099cf
26 changed files with 2162 additions and 37 deletions

View file

@ -1,5 +1,6 @@
//! Command-line arguments of the desktop app.
use std::ffi::OsString;
use std::path::PathBuf;
/// Parsed arguments.
@ -22,6 +23,21 @@ pub const USAGE: &str = "usage: lutra-desktop [--control PORT] [PATH]
--version print the version
--help print this help";
/// Parses the raw arguments after the program name.
///
/// # Errors
/// A message for an argument that is not valid Unicode, or as [`parse`].
pub fn parse_os(args: impl IntoIterator<Item = OsString>) -> Result<Args, String> {
let args = args
.into_iter()
.map(|arg| {
arg.into_string()
.map_err(|arg| format!("argument {arg:?} is not valid Unicode"))
})
.collect::<Result<Vec<_>, _>>()?;
parse(args)
}
/// Parses the arguments after the program name.
///
/// # Errors
@ -90,4 +106,10 @@ mod tests {
assert!(p(&["--frobnicate"]).is_err());
assert!(p(&["a", "b"]).is_err());
}
#[test]
fn reads_raw_arguments() {
let a = parse_os([OsString::from("--control"), OsString::from("7937")]).unwrap();
assert_eq!(a.control, Some(7937));
}
}