docs(comments): rewrite comments across all crates to the guidelines
Sweep every first-party crate source (1956 .rs files) to the project comment guidelines: delete redundant restatements, decorative banners, change narration, and end-of-line comments; keep and tighten the crucial ones (invariants, bug rationale, SAFETY blocks, ported-source attribution). No functional code changed. Every edit is proven comment-only against the prior tree by a comment-stripping lexer (string/char/raw-string aware) plus a separate doctest-fence check. Where removing a comment made rustfmt or clippy want to re-lay-out adjacent code, the minimal triggering comment is restored so code tokens stay byte-identical. Gates green: cargo fmt --all --check (0 diffs), cargo check and cargo clippy --workspace --all-targets (0 warnings). Adds scripts/check_codegen_comment_guidelines.py — the enforcement gate for these guidelines (flags banners, end-of-line comments, change narration, and commented-out code).
This commit is contained in:
1 parent
ff0fb56c67
commit
a02b555e66
1458 files changed
+10729
-21750
No files matched your search
@@ -1,4 +1,4 @@
|
||||
//! `web_fetch` tool — client-side URL fetching with improved HTML-to-markdown
|
||||
//! `web_fetch` tool — client-side URL fetching with HTML-to-markdown
|
||||
//! conversion and SSRF protection.
|
||||
//!
|
||||
//! Fetches a URL via `reqwest`, converts HTML to markdown via `htmd` (with
|
||||
@@ -21,10 +21,6 @@ pub use config::WebFetchParams;
|
||||
pub use domain::{DomainMatcher, domain_from_url};
|
||||
pub use error::WebFetchError;
|
||||
|
||||
// ───────────────────────────────────────────────────────────────────────────
|
||||
// Config enum (feature flag gating)
|
||||
// ───────────────────────────────────────────────────────────────────────────
|
||||
|
||||
/// Configuration for the `web_fetch` tool.
|
||||
///
|
||||
/// When `Enabled`, the tool is registered and a `WebFetchClient` is injected
|
||||
@@ -34,13 +30,11 @@ pub enum WebFetchConfig {
|
||||
#[default]
|
||||
Disabled,
|
||||
Enabled {
|
||||
/// Runtime parameters (allowed_domains, proxy_endpoint, timeouts, etc.)
|
||||
params: WebFetchParams,
|
||||
},
|
||||
}
|
||||
|
||||
impl WebFetchConfig {
|
||||
/// Returns `true` when the config is the `Enabled` variant.
|
||||
pub fn is_enabled(&self) -> bool {
|
||||
matches!(self, Self::Enabled { .. })
|
||||
}
|
||||
@@ -51,21 +45,12 @@ use crate::types::requirements::{Expr, ToolRequirement};
|
||||
use crate::types::resources::SessionFolder;
|
||||
use crate::types::tool::{ToolKind, ToolNamespace};
|
||||
|
||||
// ───────────────────────────────────────────────────────────────────────────
|
||||
// Input
|
||||
// ───────────────────────────────────────────────────────────────────────────
|
||||
|
||||
#[derive(Debug, Clone, serde::Serialize, serde::Deserialize, schemars::JsonSchema)]
|
||||
pub struct WebFetchInput {
|
||||
/// The URL to fetch content from.
|
||||
#[schemars(description = "The URL to fetch content from.")]
|
||||
pub url: String,
|
||||
}
|
||||
|
||||
// ───────────────────────────────────────────────────────────────────────────
|
||||
// Tool
|
||||
// ───────────────────────────────────────────────────────────────────────────
|
||||
|
||||
#[derive(Debug, Default)]
|
||||
pub struct WebFetchTool;
|
||||
|
||||
|
||||
Reference in new issue
Block a user