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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
//! Подкоманда `light dev`: горячая перезагрузка приложения Light.
//!
//! Запускает приложение (`cargo run -p <пакет> --features dev-mode`) и
//! перезапускает его при изменении исходников, сохраняя состояние через
//! DevTools (см. [`light_fw_cli_core::dev`]).
use std::io::IsTerminal;
use std::path::Path;
use light_fw_cli_core::check::{build_check_report, ensure_components_present, parse_yn};
use light_fw_cli_core::dev::{parse_dev_command, run as run_dev};
use light_fw_devtools_web::{config, server};
/// Аргументы подкоманды `dev`.
///
/// Первый свободный аргумент (не начинающийся с `-`) — имя пакета; `--verbose`
/// включает подробные логи; всё остальное передаётся в `cargo run` как есть
/// (например, `--release`).
#[derive(clap::Args, Debug)]
pub struct DevArgs {
/// Пакет воркспейса, который запускается.
///
/// Если не указан, `cargo run` запустит пакет по умолчанию (из текущего
/// каталога).
pub package: Option<String>,
/// Включить подробные логи (debounce, hash-dedup, notify events).
#[arg(long, default_value_t = false)]
pub verbose: bool,
/// Полный сброс кэша dev-сборки перед стартом (hot-build, hot-run, state
/// и артефакты deps текущего пакета). Смысл — при смене версии фреймворка,
/// когда auto-invalidation уже не помогает (например, переезд между ветками
/// или ручная замена исходников light-fw-core).
#[arg(long, default_value_t = false)]
pub clean: bool,
/// Сохранять state.json между ВСЕМИ запусками (в т.ч. cold start).
/// Эквивалент LIGHT_PRESERVE_STATE=1. По умолчанию false.
#[arg(long, default_value_t = false)]
pub preserve_state: bool,
/// ТЗ 0.16.0: режим агента — автоматически создавать session recorder,
/// логировать все DevTools-команды и генерировать summary.md при выходе.
#[arg(long, default_value_t = false)]
pub agent: bool,
/// Не устанавливать недостающие компоненты автоматически (только показать
/// список и инструкции `light add`).
#[arg(long, default_value_t = false)]
pub no_auto_install: bool,
/// ТЗ 0.18.0: не запускать web UI DevTools (по умолчанию включён).
#[arg(long, default_value_t = false)]
pub no_web: bool,
/// ТЗ 0.18.0: порт web UI DevTools (по умолчанию 9228; при указании
/// web-сервер включается даже если в конфиге `enabled: false`).
#[arg(long)]
pub web_port: Option<u16>,
/// Дополнительные флаги cargo (включая `--`, если нужно передать аргументы
/// самому приложению). Пример: `--release`.
#[arg(trailing_var_arg = true)]
pub extra_cargo_args: Vec<String>,
}
/// Точка входа подкоманды `light dev`.
pub fn run(args: DevArgs) -> anyhow::Result<i32> {
// Автоматическая проверка компонентов перед запуском.
let project_root = Path::new(".").to_path_buf();
if project_root.join("Cargo.toml").exists() {
let install_fn = |name: &str| -> light_fw_cli_core::Result<()> {
// ТЗ 0.17.2: автоподгрузка явно уважает дефолтные фичи `light-fw`
// (не отключает их); опция прописана в обоих вызовах.
let opts = light_fw_cli_core::add::AddOptions {
default_features: true,
..Default::default()
};
let plan = light_fw_cli_core::add::plan_add(&project_root, name, &opts)?;
let _ = light_fw_cli_core::add::apply_add(
&project_root,
&light_fw_cli_core::process::SystemRunner,
&plan,
&opts,
)?;
Ok(())
};
let auto_install = !args.no_auto_install;
let ready = ensure_components_present(&project_root, &install_fn, auto_install)?;
if !ready {
return Ok(1);
}
// Этап 6 Plugin API: авто-детект кастомных тегов (`<datepicker />` и
// прочие «неизвестные стандартному HTML» теги из шаблонов проекта).
// `ensure_components_present` выше смотрит ТОЛЬКО standard-component
// зависимости; здесь — теги, которые должен предоставлять плагин.
//
// * `available` (тег в bundled/remote реестре, плагин не установлен)
// → TTY: спросить «Установить <crate>? [Y/n]»; Y или non-TTY →
// `plan_add`/`apply_add`; N → warn и продолжить (сборка может
// упасть, это на совести пользователя);
// * `unknown` (тега нет ни в ядре, ни в реестре) → error +
// подсказка `light search <tag>` и выход с кодом 1.
//
let check_report = match build_check_report(&project_root) {
Ok(report) => report,
Err(e) => {
eprintln!("light dev: не удалось построить отчёт `light check`: {e}");
return Ok(1);
}
};
if !check_report.available.is_empty() || !check_report.unknown.is_empty() {
eprintln!("\n🔍 Light: обнаружены кастомные теги в шаблонах проекта:\n");
for a in &check_report.available {
eprintln!(
" 🟡 <{}> — доступно (не установлено): {}",
a.tag, a.requirement
);
}
for t in &check_report.unknown {
eprintln!(
" 🔴 <{t}> — неизвестно (нет ни в ядре (light-fw-core), ни в реестре Light"
);
}
}
for a in &check_report.available {
let mut install = true;
if !auto_install {
// `--no-auto-install`: только показать список и инструкции
// `light add`; ничего не устанавливаем.
install = false;
eprintln!(
" → вручную: light add {} (--feature / --features при необходимости)",
a.crate_name
);
} else if std::io::stdin().is_terminal() {
// TTY-режим: спрашиваем пользователя (Y по умолчанию).
print!(
" Установить {}? [Y/n] ",
a.requirement
.split_whitespace()
.next()
.unwrap_or(a.crate_name.as_str())
);
std::io::Write::flush(&mut std::io::stderr()).ok();
let mut line = String::new();
if std::io::stdin().read_line(&mut line).is_err() {
// В CI/пайплайне stdin может закрыться — считаем «да»
// (auto-install по умолчанию включён).
eprintln!("(ответ не получен, устанавливаю автоматически)");
} else if !parse_yn(&line) {
install = false;
eprintln!(
" ⚠️ Отказано. Сборка может не пройти, пока <{}> не подключён.",
a.tag
);
}
}
// non-TTY + auto_install → install остаётся `true` (автоустановка).
if install {
eprintln!("⏳ Устанавливаю {} …", a.crate_name);
if let Err(e) = (install_fn)(&a.crate_name) {
eprintln!(
"❌ Не удалось установить {}: {e}\n Попробуйте вручную: light add {}",
a.crate_name, a.crate_name
);
return Ok(1);
}
eprintln!("✅ {} установлен", a.crate_name);
}
}
if !check_report.unknown.is_empty() {
eprintln!();
for t in &check_report.unknown {
eprintln!(
" ❌ <{t}> — неизвестный тег. Проверьте опечатку или найдите плагин: `light search {t}`"
);
}
eprintln!();
return Ok(1);
}
}
let verbose = args.verbose;
let mut raw: Vec<String> = Vec::new();
if let Some(package) = &args.package {
raw.push(package.clone());
}
if verbose {
raw.push("--verbose".into());
}
if args.clean {
raw.push("--clean".into());
}
if args.preserve_state {
raw.push("--preserve-state".into());
}
if args.agent {
raw.push("--agent".into());
}
if args.no_web {
raw.push("--no-web".into());
}
if let Some(port) = args.web_port {
raw.push(format!("--web-port={port}"));
}
raw.extend(args.extra_cargo_args);
// Повторно разбираем через чистую функцию `parse_dev_command`, чтобы
// поведение CLI полностью соответствовало логике библиотеки (и чтобы
// тесты могли покрывать именно её).
let parsed = parse_dev_command(&raw);
eprintln!(
"⏳ Запуск (cargo run{} --features dev-mode {})",
parsed
.package
.as_ref()
.map(|p| format!(" -p {p}"))
.unwrap_or_default(),
parsed.extra_cargo_args.join(" "),
);
// ТЗ 0.18.0: web UI DevTools — запускаем ДО `run_dev()`, чтобы сервер был
// готов, когда приложение откроет TCP 9229. Приоритет: --no-web >
// --web-port (implies enabled) > config `dev.devtools.web.enabled:false`
// > default (enabled, port 9228).
let web = if !args.no_web {
let cfg_json = std::fs::read_to_string("light.config.json").unwrap_or_default();
let web_cfg = config::parse(&cfg_json);
let effective_enabled = args.web_port.is_some() || web_cfg.enabled;
if effective_enabled {
let opts = server::ServeOptions {
config: light_fw_devtools_web::config::WebConfig {
enabled: true,
port: args.web_port.unwrap_or(web_cfg.port),
},
devtools_port: 9229,
};
Some(server::serve(opts, args.web_port))
} else {
eprintln!("light dev: web UI DevTools disabled (config)");
None
}
} else {
None
};
// `run_dev` возвращает `io::Result` (ядро CLI не тянет anyhow); здесь, в
// бинарном слое, переводим в anyhow.
let code = match run_dev(&parsed) {
Ok(code) => code,
Err(e) => return Err(anyhow::anyhow!("{e}")),
};
// ТЗ 0.18.0: останавливаем web UI DevTools (блокирующее join до 3 c).
if let Some(w) = web {
w.stop();
}
Ok(code)
}