ossctl-core 0.5.0

//! Deterministic repo-fact detector (port of `infer-repo-facts.py` —
//! ADR-0001 §3).
//!
//! [`gather`] is a pure function of `(repo tree, git HEAD)`: it sniffs
//! ecosystems and manifests, counts committers, reads tags, detects CI/bot/
//! issues signals, extracts a README self-label and description, and applies the
//! SCHEMA.md §4 maturity truth table. All I/O goes through the [`Fs`] and
//! [`GitRepo`] ports (`crate::ports`), so the detector is exercised entirely
//! against in-memory fakes and never touches the real filesystem or git — the
//! whole point of the injected-port seam (ADR-0001 §2).
//!
//! The report shape lives in [`crate::protocol::facts`] (the versioned wire
//! DTO); this module owns only the detection logic. It is **reproducible**: for
//! a fixed repository state *and* wall-clock day it produces byte-identical
//! facts, so `/oss-init` and the readiness `audit` reading the same `ossctl
//! facts` output agree on maturity and the gated core. It is not a pure function
//! of `HEAD` alone: the recent-committer count uses git's `--since=1 year ago`
//! (evaluated against the current clock) and reads all refs/tags, so a run that
//! crosses the one-year boundary, or after refs change, can shift — the same
//! time-relative behavior `infer-repo-facts.py` has.
//!
//! ## Fidelity to the Python detector
//!
//! Field names, the manifest set, the SemVer/monorepo-prefix handling, the CI
//! globs, the spike-label list, and the maturity truth table all mirror
//! `infer-repo-facts.py`. TOML manifests (`Cargo.toml`, `pyproject.toml`) are
//! parsed by scanning the relevant `[section]` for `key = "value"` (single or
//! double quotes) rather than via a full TOML library — the contract normalizer
//! avoids new parser deps the same way. This matches the Python `tomllib` path
//! for the common manifest shapes; two edge cases are **not** reproduced and are
//! deliberately out of scope: escaped/multiline TOML strings, and Python's
//! whole-file regex *fallback* that fires only when `tomllib` itself fails on
//! malformed TOML (there, Python may surface a `name` from an unrelated table;
//! this port returns none). Both are exotic in a real `pyproject.toml`.

use std::path::Path;

use crate::contract::schema::{Ecosystem, Maturity};
use crate::ports::{Fs, GitRepo};
use crate::protocol::facts::{Facts, MaturitySignals, Package, RustWorkspace, WorkspaceMember};

/// Root-level manifests, in the canonical probe order. The ecosystem order here
/// also fixes the order `ecosystems` and `packages` are emitted in.
const MANIFESTS: &[(&str, Ecosystem)] = &[
    ("Cargo.toml", Ecosystem::Rust),
    ("package.json", Ecosystem::Node),
    ("pyproject.toml", Ecosystem::Python),
    ("setup.py", Ecosystem::Python),
    ("go.mod", Ecosystem::Go),
];

/// README tokens that self-label a project as pre-release (a spike signal).
/// Matched case-insensitively as whole substrings; kept small + explicit for
/// reproducibility (mirrors the Python `SPIKE_LABELS`).
const SPIKE_LABELS: &[&str] = &[
    "work in progress",
    "work-in-progress",
    "wip",
    "experimental",
    "prototype",
    "pre-alpha",
    "proof of concept",
    "proof-of-concept",
    "status: private, early",
    "not production ready",
    "not production-ready",
    "early prototype",
    "spike",
];

/// CI configuration paths. `.github/workflows` is a directory that counts only
/// when non-empty; the rest are single-file configs that count on existence.
const CI_GLOBS: &[&str] = &[
    ".github/workflows",
    ".gitlab-ci.yml",
    ".circleci",
    "azure-pipelines.yml",
    ".drone.yml",
    "Jenkinsfile",
];

/// Character cap for a manifest read (matches the Python `_read` default, which
/// reads decoded characters, not bytes).
const MANIFEST_LIMIT: usize = 200_000;
/// Character cap for a README read (matches the Python text-mode README read).
const README_LIMIT: usize = 4_000;
/// Character cap for the emitted `description`.
const DESCRIPTION_CHARS: usize = 120;

/// Detect the deterministic repo facts under `repo_root`.
///
/// `repo_root` is used verbatim for the emitted `repo_root` field and as the
/// join base for filesystem probes; the caller canonicalizes it (mirroring the
/// Python `os.path.realpath`) before passing it in. Never mutates anything.
#[must_use]
pub fn gather(repo_root: &Path, fs: &dyn Fs, git: &dyn GitRepo) -> Facts {
    let is_git = git.is_work_tree();
    // `has_commits` needs both a work tree and a resolvable HEAD (an unborn repo
    // is a work tree with no HEAD).
    let has_commits = is_git && git.head_commit().is_ok();

    let (ecosystems, packages) = detect_manifests(repo_root, fs);
    // The Rust workspace's publishable member graph — off-wire plumbing the release
    // planner derives a dependency-ordered publish set from (`None` for a repo with
    // no multi-crate Cargo workspace). Derived from the same manifests as `packages`
    // but carrying the publish flags + intra-workspace dependency edges `packages`
    // omits, so a downstream repo that declares only its bin crate still gets its lib
    // crate planned, lib-before-bin (`release-rust-workspace-multicrate`).
    let rust_workspace = detect_rust_workspace(repo_root, fs);

    // ── committers (mailmap-aware, whole `--all` history) ──
    let (committers_total, committers_recent_year) = if has_commits {
        let total = git.shortlog(None).map_or(0, count_lines);
        let recent = git.shortlog(Some("1 year ago")).map_or(0, count_lines);
        (total, recent)
    } else {
        (0, 0)
    };

    // ── tags / releases ──
    let tags = if has_commits {
        git.tags().unwrap_or_default()
    } else {
        Vec::new()
    };
    let semver_tags: Vec<(u64, u64, u64, bool)> =
        tags.iter().filter_map(|t| semver_parse(t)).collect();
    let has_semver_tag = !semver_tags.is_empty();
    // Count *shipped* releases: non-prerelease SemVer tags at `>=0.1.0`. A `0.0.x`
    // tag is SemVer's initial-scratch space ("anything MAY change at any time"),
    // and a `-rc`/`-alpha` prerelease is not shipped — neither is counted. A
    // consumer can recompute this from the emitted `tags` with the same parse.
    let shipped_release_tags = semver_tags
        .iter()
        .filter(|&&(major, minor, _, pre)| !pre && (major >= 1 || minor >= 1))
        .count();
    let ge_1_0_tag = semver_tags
        .iter()
        .any(|&(major, _, _, pre)| major >= 1 && !pre);
    let manifest_ge_1_0 = packages
        .iter()
        .any(|p| version_ge_1_0(p.version.as_deref()));
    let has_ge_1_0_release = ge_1_0_tag || manifest_ge_1_0;

    // ── CI presence ──
    let has_ci = CI_GLOBS.iter().any(|glob| {
        let path = repo_root.join(glob);
        if !fs.exists(&path) {
            return false;
        }
        if glob.ends_with("workflows") {
            // A workflows *directory* counts only when it holds an entry.
            fs.read_dir(&path).is_ok_and(|e| !e.is_empty())
        } else {
            true
        }
    });

    // ── dependency bot ──
    let dependency_bot = if fs.is_file(&repo_root.join(".github/dependabot.yml")) {
        Some("dependabot".to_string())
    } else if ["renovate.json", ".renovaterc", ".renovaterc.json"]
        .iter()
        .any(|f| fs.is_file(&repo_root.join(f)))
    {
        Some("renovate".to_string())
    } else {
        None
    };

    let has_issues_dir = fs.is_dir(&repo_root.join("issues"));

    // ── README self-label + description ──
    let readme_text = ["README.md", "README.rst", "README.txt", "README"]
        .iter()
        .find_map(|name| {
            let text = read_text(fs, &repo_root.join(name), README_LIMIT)?;
            (!text.is_empty()).then_some(text)
        });
    let readme_self_label = readme_text.as_deref().and_then(|text| {
        let low = text.to_lowercase();
        SPIKE_LABELS
            .iter()
            .any(|label| low.contains(label))
            .then(|| "spike".to_string())
    });
    let description = detect_description(repo_root, fs, &packages, readme_text.as_deref());

    // ── maturity inference (SCHEMA.md §4, production first, tie → mvp) ──
    //
    // A deliberately-pre-1.0 (ZeroVer) project can still be production-grade: the
    // version number is not release maturity. The `>=1.0` gate is really a
    // stability *declaration*; below 1.0 that declaration is absent, so the
    // `zerover_release_evidence` path requires compensating evidence of a
    // maintained release process — a dependency-update bot configured **and** a
    // release *cadence* (>=2 shipped `>=0.1.0` releases). A single tag is a
    // moment; two prove the project has actually iterated a release more than
    // once, which a lone `git tag` cannot fake. Combined with the always-required
    // CI and >=2 recent committers, this is materially harder to inflate than the
    // old "only a tag" concern.
    //
    // The asymmetry (a `>=1.0` project reaches `production` without a bot, a 0.x
    // one does not) is intentional: `>=1.0` already carries the stability signal
    // this path has to reconstruct. These remain presence/name heuristics over a
    // cooperative repo (CI/bot detected by path, tags by name) — not adversarial
    // proofs — and `/oss-init` surfaces every signal to a human before it lands
    // in the contract. Each input is already in the report (`has_ci`,
    // `dependency_bot`, `tags` — from which `shipped_release_tags` recomputes via
    // the same parse — `committers_recent_year`, `has_ge_1_0_release`), so the
    // decision is re-derivable without a new wire field.
    let zerover_release_evidence = dependency_bot.is_some() && shipped_release_tags >= 2;
    let release_gate = has_ge_1_0_release || zerover_release_evidence;
    let production = committers_recent_year >= 2 && has_ci && release_gate;
    let spike =
        !has_ci && !has_semver_tag && (committers_total <= 1 || readme_self_label.is_some());
    let inferred_maturity = if production {
        Maturity::Production
    } else if spike {
        Maturity::Spike
    } else {
        Maturity::Mvp
    };

    Facts {
        repo_root: repo_root.display().to_string(),
        is_git,
        has_commits,
        ecosystems,
        packages,
        committers_total,
        committers_recent_year,
        tags,
        has_semver_tag,
        has_ge_1_0_release,
        has_ci,
        dependency_bot,
        has_issues_dir,
        readme_self_label,
        description,
        maturity_signals: MaturitySignals { production, spike },
        inferred_maturity,
        rust_workspace,
    }
}

/// Sniff root-level manifests into the ordered `ecosystems` + `packages` lists.
fn detect_manifests(repo_root: &Path, fs: &dyn Fs) -> (Vec<Ecosystem>, Vec<Package>) {
    let mut ecosystems: Vec<Ecosystem> = Vec::new();
    let mut packages: Vec<Package> = Vec::new();
    for &(fname, eco) in MANIFESTS {
        let path = repo_root.join(fname);
        if !fs.is_file(&path) {
            continue;
        }
        let text = read_text(fs, &path, MANIFEST_LIMIT);
        let parsed = text
            .as_deref()
            .and_then(|t| parse_manifest(fname, t))
            .unwrap_or_default();
        // A Cargo virtual workspace (no `[package]`) still marks the repo rust.
        if !ecosystems.contains(&eco) {
            ecosystems.push(eco);
        }
        // A Cargo *virtual workspace* (no `[package]`) declares its real crates in
        // `[workspace].members`: descend into each member manifest and emit one
        // entry per member with its resolved name + version, rather than a single
        // null-named root entry.
        if fname == "Cargo.toml" && parsed.package.is_none() {
            if let Some(text) = text.as_deref() {
                if push_workspace_members(repo_root, fs, text, eco, &mut packages) {
                    continue;
                }
            }
            // Not a members-bearing virtual workspace (or no member manifest
            // resolved): fall through to the null root entry — the repo is still
            // rust, and the null-named entry preserves today's signal.
        }
        // `Cargo.toml`/`go.mod` always yield a package entry (even without a
        // declared name); the others only when they name a package.
        if parsed.package.is_some() || fname == "Cargo.toml" || fname == "go.mod" {
            packages.push(Package {
                ecosystem: eco,
                manifest: fname.to_string(),
                package: parsed.package,
                version: parsed.version,
            });
        }
    }
    // `binary` only when NO package ecosystem is detected — never additive.
    if ecosystems.is_empty() {
        ecosystems.push(Ecosystem::Binary);
    }
    (ecosystems, packages)
}

/// Enumerate a Cargo virtual workspace's members into `packages`, one entry per
/// member manifest that resolves through `fs`. Explicit members are read in
/// declaration order; a trailing single-level glob (`crates/*`) is expanded by
/// listing its directory through the `Fs` port and sorting the entries, so the
/// emitted order is deterministic regardless of the underlying read-dir order.
/// `[workspace].exclude` entries are dropped, and duplicate member paths (e.g.
/// an explicit member also matched by a glob) are emitted once.
///
/// Each member reports its own `[package].name`; the version is its literal
/// `[package].version`, or — when the member declares `version.workspace = true`
/// (dotted) or `version = { workspace = true }` (inline) — the version inherited
/// from the root `[workspace.package]` table.
///
/// Returns `true` when at least one member manifest was emitted (the caller then
/// skips the null root entry); `false` when the root has no `members` array or no
/// listed member manifest resolved (the caller keeps today's null-entry behavior).
fn push_workspace_members(
    repo_root: &Path,
    fs: &dyn Fs,
    root_text: &str,
    eco: Ecosystem,
    packages: &mut Vec<Package>,
) -> bool {
    let ws_pkg = toml_section(root_text, "workspace.package");
    let dirs = workspace_member_dirs(repo_root, fs, root_text);
    let before = packages.len();
    for rel in &dirs {
        let manifest_path = repo_root.join(rel).join("Cargo.toml");
        let Some(member_text) = read_text(fs, &manifest_path, MANIFEST_LIMIT) else {
            continue;
        };
        let (package, version) = resolve_member_name_version(&member_text, ws_pkg.as_deref());
        packages.push(Package {
            ecosystem: eco,
            manifest: format!("{rel}/Cargo.toml"),
            package,
            version,
        });
    }
    packages.len() > before
}

/// Resolve a Cargo virtual-workspace root's `[workspace].members` to the ordered,
/// de-duplicated, **existing** member directories (manifest-relative, no trailing
/// slash) — the single member-enumeration used by both the `packages` emission and
/// the release-planner workspace graph, so the two never drift.
///
/// Applies the rules the fact detector has always used: escape-proof (an absolute
/// or `..`-bearing member is rejected — with a real `Fs` those would read manifests
/// outside `repo_root` and taint the facts), trailing single-level glob (`crates/*`,
/// bare `*`) expansion via the `Fs` port with sorted entries (deterministic
/// regardless of read-dir order), `[workspace].exclude` removal, first-seen dedup,
/// and dropping any member whose `Cargo.toml` does not resolve. Empty when the root
/// declares no `[workspace].members` array (not a members-bearing virtual workspace)
/// or none resolve.
fn workspace_member_dirs(repo_root: &Path, fs: &dyn Fs, root_text: &str) -> Vec<String> {
    let Some(ws_block) = toml_section(root_text, "workspace") else {
        return Vec::new();
    };
    let members = match toml_str_array(&ws_block, "members") {
        Some(members) if !members.is_empty() => members,
        _ => return Vec::new(),
    };
    let exclude: Vec<String> = toml_str_array(&ws_block, "exclude")
        .unwrap_or_default()
        .iter()
        .map(|e| e.trim_end_matches('/').to_string())
        .collect();
    // Manifest-relative dirs already collected — dedup preserving first-seen order.
    let mut out: Vec<String> = Vec::new();
    for member in members {
        let member = member.trim_end_matches('/');
        if member.is_empty() || member.starts_with('/') || member.split('/').any(|c| c == "..") {
            continue;
        }
        if let Some(prefix) = glob_parent(member) {
            // Trailing single-level glob (`crates/*`, bare `*`): expand one level.
            let dir = if prefix.is_empty() {
                repo_root.to_path_buf()
            } else {
                repo_root.join(prefix)
            };
            let mut names = fs.read_dir(&dir).unwrap_or_default();
            names.sort();
            for name in names {
                let rel = if prefix.is_empty() {
                    name
                } else {
                    format!("{prefix}/{name}")
                };
                push_member_dir(repo_root, fs, &rel, &exclude, &mut out);
            }
            continue;
        }
        // A glob shape we do not expand (`?`, character classes, a non-trailing
        // `*`): skip rather than probe a literal metacharacter path.
        if member.contains(['*', '?']) {
            continue;
        }
        push_member_dir(repo_root, fs, member, &exclude, &mut out);
    }
    out
}

/// Add member dir `rel` to `out` unless it is `exclude`d, already collected, or its
/// `Cargo.toml` does not resolve through `fs`.
fn push_member_dir(
    repo_root: &Path,
    fs: &dyn Fs,
    rel: &str,
    exclude: &[String],
    out: &mut Vec<String>,
) {
    let rel = rel.trim_end_matches('/');
    if exclude.iter().any(|e| e == rel) || out.iter().any(|s| s == rel) {
        return;
    }
    if !fs.is_file(&repo_root.join(rel).join("Cargo.toml")) {
        return;
    }
    out.push(rel.to_string());
}

/// Detect the Rust workspace's crates.io-**publishable** member graph — the
/// off-wire plumbing [`Facts::rust_workspace`] carries for the release planner.
///
/// `None` unless the repo root is a members-bearing Cargo *virtual workspace* (the
/// shape that expresses a lib+bin split): reads each member manifest for its
/// `[package].name`, version (honoring `version.workspace = true` inheritance),
/// `publish` allow-list, and intra-workspace dependency edges, then keeps only the
/// crates.io-publishable members (matching the cargo adapter's cut-time `cargo
/// metadata` filter — a `publish = false` member, or one restricted to a
/// non-crates.io registry, is dropped) with their edges restricted to other
/// publishable members. Members are returned in workspace declaration order; the
/// planner applies the topological publish ordering. `None` when no publishable
/// named member resolves (nothing for the planner to expand).
///
/// **Edges gate publish ORDER, and a missed edge fails a cut CLOSED — it is not a
/// free "hint".** The coordinator walks the plan's target order; the cargo adapter
/// re-derives the graph from `cargo metadata` and index-waits on each crate's real
/// deps, but it does **not** re-order the plan. So a missed ordering edge that puts a
/// dependent before its dependency makes the dependent's `cargo publish` fail on the
/// not-yet-indexed sibling — a safe, no-mis-publish failure, but a *failed release for
/// a valid workspace*. The edge parse is therefore precise where it counts:
/// [`member_dependency_edges`] treats only `path`/`workspace` dependencies as edges
/// (a registry dep sharing a member's name is not an edge, so no false constraint /
/// false cycle), and reads the plain, target-specific, sub-table, and dotted-key
/// dependency forms plus inline `package = "…"` renames. Its two documented blind
/// spots (a rename inherited through the root `[workspace.dependencies]`, and a
/// multi-line inline table) each fail closed the same way.
///
/// One parsed workspace member before the publishability filter — the intermediate
/// [`detect_rust_workspace`] reduces to the published [`WorkspaceMember`] set.
struct RawMember {
    package: String,
    version: Option<String>,
    publishable: bool,
    /// Intra-workspace dependency edges: crate name + the literal version
    /// requirement the manifest declares for it (or `None` for a path-only edge).
    deps: Vec<(String, Option<String>)>,
}

fn detect_rust_workspace(repo_root: &Path, fs: &dyn Fs) -> Option<RustWorkspace> {
    let root_path = repo_root.join("Cargo.toml");
    if !fs.is_file(&root_path) {
        return None;
    }
    let root_text = read_text(fs, &root_path, MANIFEST_LIMIT)?;
    let dirs = workspace_member_dirs(repo_root, fs, &root_text);
    if dirs.is_empty() {
        return None;
    }
    let ws_pkg = toml_section(&root_text, "workspace.package");

    // First pass: parse every named member (name, version, publishability, edges).
    let mut raw: Vec<RawMember> = Vec::new();
    for rel in &dirs {
        let Some(text) = read_text(fs, &repo_root.join(rel).join("Cargo.toml"), MANIFEST_LIMIT)
        else {
            continue;
        };
        let (package, version) = resolve_member_name_version(&text, ws_pkg.as_deref());
        // A member with no `[package].name` cannot be a publish target — skip it (a
        // nested virtual workspace, or a malformed manifest).
        let Some(package) = package else { continue };
        raw.push(RawMember {
            package,
            version,
            publishable: member_publishable_to_crates_io(&text),
            deps: member_dependency_edges(&text),
        });
    }

    // Keep only crates.io-publishable members; restrict each member's edges to the
    // OTHER publishable members (a dep on a non-publishable member does not gate the
    // publish order, and a self-edge is meaningless).
    let publishable_names: std::collections::BTreeSet<&str> = raw
        .iter()
        .filter(|m| m.publishable)
        .map(|m| m.package.as_str())
        .collect();
    let members: Vec<WorkspaceMember> = raw
        .iter()
        .filter(|m| m.publishable)
        .map(|m| {
            // Restrict to edges to OTHER publishable members; carry each edge's literal
            // requirement string (when the manifest declared one) so the pin-rewrite
            // derivation can key precisely on the `=<ver>` lockstep convention.
            let mut dep_reqs: std::collections::BTreeMap<String, String> =
                std::collections::BTreeMap::new();
            for (name, req) in &m.deps {
                if name.as_str() == m.package || !publishable_names.contains(name.as_str()) {
                    continue;
                }
                if let Some(req) = req {
                    // First declaration wins (a crate appearing in both `[dependencies]`
                    // and `[build-dependencies]` shares one requirement in practice).
                    dep_reqs.entry(name.clone()).or_insert_with(|| req.clone());
                }
            }
            let mut workspace_deps: Vec<String> = m
                .deps
                .iter()
                .map(|(name, _req)| name.clone())
                .filter(|d| d.as_str() != m.package && publishable_names.contains(d.as_str()))
                .collect();
            workspace_deps.sort();
            workspace_deps.dedup();
            WorkspaceMember {
                package: m.package.clone(),
                version: m.version.clone(),
                workspace_deps,
                dep_reqs,
            }
        })
        .collect();
    if members.is_empty() {
        return None;
    }
    Some(RustWorkspace { members })
}

/// Whether a Cargo member manifest permits publishing to crates.io — the same
/// predicate the cargo adapter applies at cut time (`publishable_to_crates_io`), but
/// read from raw manifest text rather than `cargo metadata`.
///
/// `publish` absent ⇒ any registry (yes). `publish = false` ⇒ no. `publish = true`
/// ⇒ yes. `publish = ["crates-io", …]` ⇒ only if the list names `crates-io`
/// (`publish = []` therefore reads as no, matching `cargo metadata`'s `Some([])`).
fn member_publishable_to_crates_io(text: &str) -> bool {
    let Some(block) = toml_section(text, "package") else {
        // No `[package]` at all — not a publishable crate. (`detect_rust_workspace`
        // already drops an unnamed member before this runs; failing closed here is a
        // defensive guard so a future name-fabrication path can never leak a
        // package-less manifest into the crates.io publish set.)
        return false;
    };
    // Array form first: `publish = ["crates-io"]`.
    if let Some(regs) = toml_str_array(&block, "publish") {
        return regs.iter().any(|r| r == CRATES_IO_REGISTRY_ALIAS);
    }
    // Bool form: `publish = false` / `publish = true`; absent ⇒ publishable.
    !matches!(toml_bool_value(&block, "publish"), Some(false))
}

/// Cargo's registry alias for crates.io — the token a member manifest's `publish`
/// allow-list must contain to be crates.io-publishable (mirrors the cargo adapter's
/// `CRATES_IO_ALIAS`).
const CRATES_IO_REGISTRY_ALIAS: &str = "crates-io";

/// Read a boolean TOML value (`key = true` / `key = false`) from a section body,
/// stripping a trailing `#` comment. `None` when the key is absent or its value is
/// not a bare bool literal (an array or table form is the caller's concern).
fn toml_bool_value(block: &str, key: &str) -> Option<bool> {
    for line in block.lines() {
        let rest = line.trim_start();
        let Some(rest) = rest.strip_prefix(key) else {
            continue;
        };
        // Whole-token match (else `publisher` would match `publish`).
        if !rest.starts_with(|c: char| c.is_whitespace() || c == '=') {
            continue;
        }
        let Some(rest) = rest.trim_start().strip_prefix('=') else {
            continue;
        };
        match strip_toml_comment(rest).trim() {
            "true" => return Some(true),
            "false" => return Some(false),
            _ => return None,
        }
    }
    None
}

/// One table the dependency-edge scanner is inside while walking a member manifest.
enum DepTable {
    /// A `[dependencies]` / `[build-dependencies]` body — including a target-specific
    /// `[target.<cfg>.dependencies]` / `[target.<cfg>.build-dependencies]`, which
    /// gate publish order exactly like the unconditional tables (crates.io validates
    /// them at `cargo publish`).
    Table,
    /// A `[dependencies.<name>]` sub-table body (plain or target-specific),
    /// accumulating whether it is a **local** dep (a `path`/`workspace` key) and its
    /// `package = "…"` rename, so the edge is emitted with the real crate name on flush.
    Sub {
        /// The sub-table key (the crate name, unless overridden by `package`).
        key: String,
        /// The `package = "…"` rename value, if the body declares one.
        package: Option<String>,
        /// Whether the body marks this an intra-workspace dep (`path`/`workspace`).
        local: bool,
        /// The literal `version = "…"` requirement the body declares, if any — carried
        /// so the pin-rewrite derivation can key on the exact `=<ver>` lockstep string.
        version: Option<String>,
    },
    /// A non-order-gating table (`[dev-dependencies]`, `[features]`, `[package]`, …).
    Other,
}

/// The intra-workspace dependency edges a Cargo member manifest declares, each paired
/// with the **literal version requirement** the manifest states for it (or `None` for a
/// path-only / `workspace = true` edge whose requirement is not in this manifest). The
/// raw edge set [`detect_rust_workspace`] intersects with the publishable member names.
///
/// **Only `path` / `workspace` dependencies are edges.** A registry dependency
/// (`serde = "1"`, or an inline table with only `version`) is NOT an intra-workspace
/// edge even when a workspace member happens to share its name — Cargo resolves
/// `serde = "1"` to crates.io, never to the local member, so treating a name
/// collision as an edge would invent a false ordering constraint (and a false cycle).
/// This mirrors Cargo's own model: a member edge exists iff the dependency resolves
/// to a `path`/`workspace` source.
///
/// The paired requirement is the precise-pin-rewrite source
/// (`release-rust-workspace-multicrate` facet 3): the planner keeps only the edge whose
/// requirement literally equals `=<from_version>`, so a caret/range/`workspace = true`
/// edge is never clobbered.
///
/// Line-oriented (no TOML dependency — matching this module's parsing style). It reads:
/// `[dependencies]` / `[build-dependencies]` and their target-specific
/// (`[target.<cfg>.dependencies]`) and sub-table (`[dependencies.<name>]`) forms;
/// inline tables (`dep = { path = "…", package = "real", version = "=X" }`), dotted keys
/// (`dep.path = "…"`, `dep.workspace = true`), and the `package = "…"` rename in each.
/// Dev-dependencies are excluded (they never gate publish order and can legitimately
/// cycle).
///
/// **Known blind spots (each fails a cut CLOSED, never mis-publishes — see
/// `detect_rust_workspace`):** a dependency inheriting a *rename* through the root
/// `[workspace.dependencies]` (`alias.workspace = true` where the root maps `alias`
/// to a differently-named crate) resolves to `alias`, missing the edge; a *multi-line*
/// inline table is read only by its first physical line; a dotted `dep.version = "…"`
/// requirement on a line separate from `dep.path` is not captured (so that edge's pin is
/// left un-rewritten — fail closed).
fn member_dependency_edges(text: &str) -> Vec<(String, Option<String>)> {
    let mut state = DepTable::Other;
    let mut out: Vec<(String, Option<String>)> = Vec::new();

    for line in text.lines() {
        let t = strip_toml_comment(line).trim();
        if let Some(header) = t.strip_prefix('[').and_then(|h| h.strip_suffix(']')) {
            // Leaving a table: flush a completed sub-table's edge before switching.
            flush_dep_subtable(&mut state, &mut out);
            state = classify_dep_table(header.trim());
            continue;
        }
        match &mut state {
            DepTable::Table => {
                if let Some(edge) = dep_edge_from_line(t) {
                    out.push(edge);
                }
            }
            DepTable::Sub {
                package,
                local,
                version,
                ..
            } => {
                // Accumulate the sub-table body: a `package` rename, the
                // `path`/`workspace` markers that make it a local edge, and the
                // `version` requirement.
                if let Some((k, v)) = split_key_value(t) {
                    match k {
                        "package" if package.is_none() => *package = extract_quoted(v),
                        "path" => *local = true,
                        "workspace" if v.trim_start().starts_with("true") => *local = true,
                        "version" if version.is_none() => *version = extract_quoted(v),
                        _ => {}
                    }
                }
            }
            DepTable::Other => {}
        }
    }
    flush_dep_subtable(&mut state, &mut out);
    out
}

/// Classify a table header into the dependency-edge scanner's [`DepTable`] state.
///
/// Recognizes the sub-table forms (`[dependencies.<name>]`,
/// `[target.<cfg>.dependencies.<name>]`) and the plain/target-specific table forms
/// (`[dependencies]`, `[target.<cfg>.build-dependencies]`), while excluding every
/// `dev-dependencies` variant. The `<cfg>` in a target header may contain dots and
/// quotes; classification keys on the unquoted `.dependencies` / `.build-dependencies`
/// suffix (and the `.dependencies.` / `.build-dependencies.` infix for sub-tables),
/// which is robust regardless of the cfg contents.
fn classify_dep_table(header: &str) -> DepTable {
    if let Some(name) = dep_subtable_name(header) {
        return DepTable::Sub {
            key: name.trim().trim_matches(['"', '\'']).to_string(),
            package: None,
            local: false,
            version: None,
        };
    }
    // dev-dependencies (plain or target-specific) never gate publish order.
    if !header.contains("dev-dependencies")
        && (header == "dependencies"
            || header == "build-dependencies"
            || header.ends_with(".dependencies")
            || header.ends_with(".build-dependencies"))
    {
        return DepTable::Table;
    }
    DepTable::Other
}

/// The `<name>` of a dependency sub-table header (`[dependencies.<name>]`,
/// `[build-dependencies.<name>]`, or their target-specific
/// `[target.<cfg>.dependencies.<name>]` forms), or `None` when the header is not a
/// dependency sub-table. Every `dev-dependencies` form yields `None`.
fn dep_subtable_name(header: &str) -> Option<&str> {
    if header.contains("dev-dependencies") {
        return None;
    }
    if let Some(name) = header
        .strip_prefix("dependencies.")
        .or_else(|| header.strip_prefix("build-dependencies."))
    {
        return Some(name);
    }
    // Target-specific: split on the LAST `.dependencies.` / `.build-dependencies.`
    // (the cfg expression precedes it and may itself contain dots).
    for infix in [".dependencies.", ".build-dependencies."] {
        if let Some(idx) = header.rfind(infix) {
            return Some(&header[idx + infix.len()..]);
        }
    }
    None
}

/// The intra-workspace edge crate name a `key = value` line under a `[dependencies]`
/// table declares, or `None` when the line is not a local (`path`/`workspace`) dep.
///
/// A registry dep (`foo = "1"`, or `foo = { version = "1" }` with no `path`) yields
/// `None` — it is not a workspace edge. A local dep yields its crate name: an inline
/// `package = "…"` rename when present, else the bare key. Dotted forms
/// (`foo.path = "…"`, `foo.workspace = true`) are recognized; a lone `foo.version` /
/// `foo.package` is not a local marker.
fn dep_edge_from_line(line: &str) -> Option<(String, Option<String>)> {
    let (key_full, val) = split_key_value(line)?;
    let mut segs = key_full.split('.');
    let crate_key = segs.next().unwrap_or("").trim().trim_matches(['"', '\'']);
    if crate_key.is_empty() {
        return None;
    }
    match segs.next().map(str::trim) {
        // Dotted local markers: `foo.path = "…"` / `foo.workspace = true`. A dotted
        // `foo.version = "…"` on a separate physical line is not carried here (each
        // line is read independently) — a documented blind spot that fails a cut
        // closed (a missing pin rewrite leaves a stale `=<from>` pin the publish
        // rejects), never mis-rewrites.
        Some("path") => Some((crate_key.to_string(), None)),
        Some("workspace") if val.trim_start().starts_with("true") => {
            Some((crate_key.to_string(), None))
        }
        // `foo.version`, `foo.package`, `foo.features`, `foo.optional`, … alone do not
        // mark a local dep.
        Some(_) => None,
        // Simple key: only an inline table with a `path`/`workspace = true` is local.
        None => {
            if !val.starts_with('{') || !inline_table_is_local(val) {
                return None;
            }
            let name = inline_table_package(val).unwrap_or_else(|| crate_key.to_string());
            Some((name, inline_table_version(val)))
        }
    }
}

/// Emit a completed dependency sub-table's edge into `out` when the body marked it a
/// local dep — its `package` rename if any, else the sub-table key. A registry
/// sub-table (no `path`/`workspace`) emits nothing. Resets `state` to [`DepTable::Other`].
fn flush_dep_subtable(state: &mut DepTable, out: &mut Vec<(String, Option<String>)>) {
    if let DepTable::Sub {
        key,
        package,
        local: true,
        version,
    } = state
    {
        out.push((
            package.clone().unwrap_or_else(|| key.clone()),
            version.clone(),
        ));
    }
    *state = DepTable::Other;
}

/// Split a TOML `key = value` line into its trimmed, unquoted key and its trimmed
/// value text, or `None` when the line has no `=` or an empty key (a blank or
/// continuation line).
fn split_key_value(line: &str) -> Option<(&str, &str)> {
    let eq = line.find('=')?;
    let key = line[..eq].trim().trim_matches(['"', '\'']);
    if key.is_empty() {
        return None;
    }
    Some((key, line[eq + 1..].trim()))
}

/// Whether an inline dependency table (`{ … }`) resolves to an intra-workspace member
/// — it declares a whole-token `path` key or `workspace = true`. A table with only a
/// `version` (a plain crates.io dep) is not local.
fn inline_table_is_local(inline: &str) -> bool {
    contains_toml_key(inline, "path") || toml_key_is_true(inline, "workspace")
}

/// Whether `s` contains `key` as a whole TOML key immediately followed (past spaces)
/// by `=` — so `path = "…"` matches but a `path` substring inside another value, or a
/// longer key like `no-default-features`, does not.
fn contains_toml_key(s: &str, key: &str) -> bool {
    scan_toml_key(s, key, |_after| true)
}

/// Whether `s` assigns `true` to a whole TOML key `key` (`workspace = true`).
fn toml_key_is_true(s: &str, key: &str) -> bool {
    scan_toml_key(s, key, |after| after.trim_start().starts_with("true"))
}

/// Scan `s` for a whole-token TOML `key` immediately followed (past spaces) by `=`,
/// and test the post-`=` remainder with `accept`. "Whole token" = the char before
/// `key` is not an identifier char (alphanumeric / `_` / `-`), so a substring inside a
/// value or a longer key never matches. Returns `true` on the first accepted match.
fn scan_toml_key(s: &str, key: &str, accept: impl Fn(&str) -> bool) -> bool {
    let mut rest = s;
    while let Some(pos) = rest.find(key) {
        let prev_is_ident = rest[..pos]
            .chars()
            .next_back()
            .is_some_and(|c| c.is_alphanumeric() || c == '_' || c == '-');
        let after = rest[pos + key.len()..].trim_start();
        if !prev_is_ident {
            if let Some(value) = after.strip_prefix('=') {
                if accept(value) {
                    return true;
                }
            }
        }
        rest = &rest[pos + key.len()..];
    }
    false
}

/// The `package = "…"` value inside an inline dependency table (`{ package = "bar",
/// version = "1" }`), or `None` when the table declares no rename. A best-effort
/// single-line scan (inline tables are single-line in practice).
///
/// Matches `package` as a **whole key** (the preceding char is not an identifier
/// char and the next non-space char is `=`), so a substring inside another value —
/// e.g. a `path = "../my-package-dir"` — is never misread as a rename key.
fn inline_table_package(inline: &str) -> Option<String> {
    let mut rest = inline;
    while let Some(pos) = rest.find("package") {
        let prev_is_ident = rest[..pos]
            .chars()
            .next_back()
            .is_some_and(|c| c.is_alphanumeric() || c == '_' || c == '-');
        let after = rest[pos + "package".len()..].trim_start();
        if !prev_is_ident {
            if let Some(value) = after.strip_prefix('=') {
                return extract_quoted(value.trim_start());
            }
        }
        // Not the rename key (a substring, or `package` not followed by `=`): keep
        // scanning past this occurrence.
        rest = &rest[pos + "package".len()..];
    }
    None
}

/// The `version = "…"` value inside an inline dependency table (`{ path = "…",
/// version = "=0.4.0" }`), or `None` when the table declares no explicit version. A
/// best-effort single-line scan matching `version` as a **whole key** — the same
/// whole-token discipline as [`inline_table_package`], so a `version` substring inside
/// another value is never misread.
fn inline_table_version(inline: &str) -> Option<String> {
    let mut rest = inline;
    while let Some(pos) = rest.find("version") {
        let prev_is_ident = rest[..pos]
            .chars()
            .next_back()
            .is_some_and(|c| c.is_alphanumeric() || c == '_' || c == '-');
        let after = rest[pos + "version".len()..].trim_start();
        if !prev_is_ident {
            if let Some(value) = after.strip_prefix('=') {
                return extract_quoted(value.trim_start());
            }
        }
        rest = &rest[pos + "version".len()..];
    }
    None
}

/// The literal parent directory of a trailing single-level glob member — `crates/*`
/// → `Some("crates")`, bare `*` → `Some("")` — or `None` when `member` is not such
/// a glob. A prefix that itself contains a glob metacharacter is not expandable.
fn glob_parent(member: &str) -> Option<&str> {
    if member == "*" {
        return Some("");
    }
    member
        .strip_suffix("/*")
        .filter(|prefix| !prefix.contains(['*', '?']))
}

/// Resolve a workspace member's `(name, version)` from its manifest text, honoring
/// `version.workspace = true` inheritance from the root `[workspace.package]`
/// block. Crate names are never workspace-inherited, so `name` is taken verbatim.
fn resolve_member_name_version(
    member_text: &str,
    ws_pkg: Option<&str>,
) -> (Option<String>, Option<String>) {
    let parsed = parse_cargo(member_text).unwrap_or_default();
    let version = parsed.version.or_else(|| {
        // Scope the inheritance probe to the member's own `[package]` block: a
        // `version.workspace = true` in an unrelated table (`[package.metadata.*]`,
        // a tool config) must not be read as `[package].version` inheritance.
        let inherits = toml_section(member_text, "package")
            .is_some_and(|block| field_inherits_workspace(&block, "version"));
        if inherits {
            ws_pkg.and_then(|block| toml_str_value(block, "version", false))
        } else {
            None
        }
    });
    (parsed.package, version)
}

/// The description: first non-empty manifest `description`, else the first
/// non-heading README line — both trimmed and truncated to 120 characters.
fn detect_description(
    repo_root: &Path,
    fs: &dyn Fs,
    packages: &[Package],
    readme_text: Option<&str>,
) -> Option<String> {
    let manifest_desc = packages.iter().find_map(|p| {
        let text = read_text(fs, &repo_root.join(&p.manifest), MANIFEST_LIMIT)?;
        let desc = parse_manifest(&p.manifest, &text)?.description?;
        (!desc.is_empty()).then_some(desc)
    });
    if let Some(desc) = manifest_desc {
        return Some(truncate_chars(desc.trim(), DESCRIPTION_CHARS));
    }
    readme_text?.lines().find_map(|line| {
        let s = line.trim();
        let is_prose =
            !s.is_empty() && !s.starts_with('#') && !s.starts_with('!') && !s.starts_with('>');
        is_prose.then(|| truncate_chars(s, DESCRIPTION_CHARS))
    })
}

// ── Manifest parsing (name + version + description) ──────────────────────────

/// The name/version/description parsed from one manifest.
#[derive(Debug, Default)]
struct ParsedManifest {
    package: Option<String>,
    version: Option<String>,
    description: Option<String>,
}

/// Dispatch to the per-manifest parser. `setup.py` yields nothing (its metadata
/// is executable, not declarative — the Python detector skips it too).
///
/// Dispatches on the manifest's *basename* so a member path
/// (`crates/ossctl-core/Cargo.toml`) parses like a root `Cargo.toml` — the
/// description pass re-reads member manifests by their stored relative path.
fn parse_manifest(fname: &str, text: &str) -> Option<ParsedManifest> {
    let base = Path::new(fname)
        .file_name()
        .and_then(|n| n.to_str())
        .unwrap_or(fname);
    match base {
        "Cargo.toml" => parse_cargo(text),
        "package.json" => parse_package_json(text),
        "pyproject.toml" => Some(parse_pyproject(text)),
        "go.mod" => Some(parse_gomod(text)),
        _ => None, // setup.py
    }
}

/// Parse a Cargo manifest's `[package]` block. Returns `None` for a virtual
/// workspace (no `[package]`), which still marks the repo rust upstream.
fn parse_cargo(text: &str) -> Option<ParsedManifest> {
    let block = toml_section(text, "package")?;
    Some(ParsedManifest {
        package: toml_str_value(&block, "name", false),
        version: toml_str_value(&block, "version", false),
        description: toml_str_value(&block, "description", true),
    })
}

fn parse_package_json(text: &str) -> Option<ParsedManifest> {
    let value: serde_json::Value = serde_json::from_str(text).ok()?;
    let field = |key: &str| {
        value
            .get(key)
            .and_then(serde_json::Value::as_str)
            .map(str::to_string)
    };
    Some(ParsedManifest {
        package: field("name"),
        version: field("version"),
        description: field("description"),
    })
}

/// Parse a `pyproject.toml`: the standard `[project]` table first, then a legacy
/// `[tool.poetry]` fallback when `[project]` names no package.
fn parse_pyproject(text: &str) -> ParsedManifest {
    let mut parsed = ParsedManifest::default();
    if let Some(block) = toml_section(text, "project") {
        parsed.package = toml_str_value(&block, "name", false);
        parsed.version = toml_str_value(&block, "version", false);
        parsed.description = toml_str_value(&block, "description", true);
    }
    if parsed.package.is_none() {
        if let Some(block) = toml_section(text, "tool.poetry") {
            parsed.package = toml_str_value(&block, "name", false);
            parsed.version = toml_str_value(&block, "version", false);
            parsed.description = toml_str_value(&block, "description", true);
        }
    }
    parsed
}

/// Parse a `go.mod`'s `module <path>` line. Always yields a (possibly empty)
/// result — a `go.mod` marks the repo go regardless of a `module` line.
fn parse_gomod(text: &str) -> ParsedManifest {
    let module = text.lines().find_map(|line| {
        line.strip_prefix("module")
            .filter(|rest| rest.starts_with(char::is_whitespace))
            .and_then(|rest| rest.split_whitespace().next())
            .map(str::to_string)
    });
    ParsedManifest {
        package: module,
        version: None,
        description: None,
    }
}

/// Extract a TOML `[header]` section body: every line after the header line up
/// to the next `[...]` line or end of file. `None` when the header is absent.
/// The header must begin the line (no indentation), matching the Python `^\[`.
fn toml_section(text: &str, header: &str) -> Option<String> {
    let needle = format!("[{header}]");
    let mut in_section = false;
    let mut out = String::new();
    for line in text.lines() {
        if in_section {
            if line.starts_with('[') {
                break;
            }
            out.push_str(line);
            out.push('\n');
        } else if line.starts_with(&needle) {
            in_section = true;
        }
    }
    in_section.then_some(out)
}

/// Find `key = "value"` within a TOML section body and return the quoted value.
/// `allow_empty` controls whether an empty `""` counts (the Python `name`/
/// `version` patterns require non-empty; `description` allows empty).
fn toml_str_value(block: &str, key: &str, allow_empty: bool) -> Option<String> {
    for line in block.lines() {
        let rest = line.trim_start();
        let Some(rest) = rest.strip_prefix(key) else {
            continue;
        };
        // The key must be a whole token: the char after it is whitespace or `=`
        // (else `name` would spuriously match `nameservers`). Mirrors the Python
        // `^\s*<key>\s*=` anchor.
        if !rest.starts_with(|c: char| c.is_whitespace() || c == '=') {
            continue;
        }
        let Some(rest) = rest.trim_start().strip_prefix('=') else {
            continue;
        };
        let Some(value) = extract_quoted(rest.trim_start()) else {
            continue;
        };
        if value.is_empty() && !allow_empty {
            return None;
        }
        return Some(value);
    }
    None
}

/// Find `key = [ "a", "b", … ]` within a TOML section body and return the quoted
/// elements, in order. Handles both the single-line array and a multi-line array
/// that spans several lines (Cargo `members`/`exclude` lists are commonly
/// formatted either way), stripping `#` comments so a commented-out element is not
/// returned. Elements are returned as their raw quoted text — glob expansion and
/// path validation are the caller's job. `None` when the key is absent.
fn toml_str_array(block: &str, key: &str) -> Option<Vec<String>> {
    // Accumulate from the `key = [` line through the line holding the closing `]`.
    let mut acc = String::new();
    let mut collecting = false;
    for line in block.lines() {
        // Drop a trailing `#` comment first, so a commented-out element
        // (`# "old-member"`) or a `]` inside a comment does not corrupt the scan.
        let line = strip_toml_comment(line);
        if collecting {
            acc.push_str(line);
            acc.push('\n');
            if line.contains(']') {
                break;
            }
            continue;
        }
        let rest = line.trim_start();
        let Some(rest) = rest.strip_prefix(key) else {
            continue;
        };
        // The key must be a whole token (else `members-extra` would match).
        if !rest.starts_with(|c: char| c.is_whitespace() || c == '=') {
            continue;
        }
        let Some(rest) = rest.trim_start().strip_prefix('=') else {
            continue;
        };
        acc.push_str(rest);
        acc.push('\n');
        collecting = true;
        if rest.contains(']') {
            break;
        }
    }
    if !collecting {
        return None;
    }
    // Slice between the first `[` and the first `]`, then pull quoted strings.
    let start = acc.find('[')?;
    let end = acc[start..].find(']')? + start;
    let mut inner = &acc[start + 1..end];
    let mut out = Vec::new();
    while let Some(pos) = inner.find(['"', '\'']) {
        let quote = inner.as_bytes()[pos] as char;
        let after = &inner[pos + 1..];
        let Some(close) = after.find(quote) else {
            break;
        };
        out.push(after[..close].to_string());
        inner = &after[close + 1..];
    }
    Some(out)
}

/// Whether a member manifest block declares `<key>.workspace = true` (dotted) or
/// `<key> = { workspace = true }` (inline) — the two forms of Cargo workspace
/// field inheritance. Used to decide whether to inherit from `[workspace.package]`.
/// Callers pass the member's `[package]` block, not the whole file, so an unrelated
/// table cannot trip the match.
fn field_inherits_workspace(block: &str, key: &str) -> bool {
    let dotted = format!("{key}.workspace");
    for line in block.lines() {
        let t = strip_toml_comment(line).trim_start();
        // Dotted: `version.workspace = true`.
        if let Some(rest) = t.strip_prefix(&dotted) {
            let rest = rest.trim_start();
            if let Some(rest) = rest.strip_prefix('=') {
                if is_true_literal(rest.trim_start()) {
                    return true;
                }
            }
            continue;
        }
        // Inline table: `version = { workspace = true }`.
        if let Some(rest) = t.strip_prefix(key) {
            if !rest.starts_with(|c: char| c.is_whitespace() || c == '=') {
                continue;
            }
            let Some(rest) = rest.trim_start().strip_prefix('=') else {
                continue;
            };
            let v = rest.trim_start();
            // Require the exact `workspace = true` entry inside the inline table —
            // a substring test would accept `{ workspace = false, x = true }`.
            if v.starts_with('{') && inline_table_has_workspace_true(v) {
                return true;
            }
        }
    }
    false
}

/// Whether `s` begins with the TOML boolean `true` as a whole token (not
/// `trueish`, not the string `"true"`), allowing a trailing comment or `}`.
fn is_true_literal(s: &str) -> bool {
    match s.strip_prefix("true") {
        Some(rest) => {
            let rest = rest.trim_start();
            rest.is_empty() || rest.starts_with(['#', '}', ','])
        }
        None => false,
    }
}

/// Whether an inline table (`{ … }`) contains an exact `workspace = true` entry.
/// Whitespace-insensitive so `{workspace=true}` and `{ workspace = true }` both
/// match, while `{ workspace = false, other = true }` does not.
fn inline_table_has_workspace_true(inline: &str) -> bool {
    let compact: String = inline.chars().filter(|c| !c.is_whitespace()).collect();
    compact.trim_start_matches('{').split(',').any(|entry| {
        entry
            .strip_prefix("workspace=true")
            .is_some_and(|r| r.is_empty() || r == "}")
    })
}

/// Return `line` with any trailing `#` comment removed, respecting `#` characters
/// that fall inside a `"`/`'` quoted string (which are literal, not comments).
fn strip_toml_comment(line: &str) -> &str {
    let mut quote: Option<u8> = None;
    for (i, &b) in line.as_bytes().iter().enumerate() {
        match quote {
            Some(q) => {
                if b == q {
                    quote = None;
                }
            }
            None => match b {
                b'"' | b'\'' => quote = Some(b),
                b'#' => return &line[..i],
                _ => {}
            },
        }
    }
    line
}

/// Read a leading quoted string — `"..."` or `'...'`. TOML allows both basic
/// (double) and literal (single) strings, and `tomllib` accepts either, so both
/// are honored here for parity. No escape handling: neither this nor the Python
/// regex `"([^"]+)"` unescapes, and manifest name/version/description do not need
/// it in practice.
fn extract_quoted(s: &str) -> Option<String> {
    let quote = s.chars().next().filter(|&c| c == '"' || c == '\'')?;
    let s = &s[1..];
    let end = s.find(quote)?;
    Some(s[..end].to_string())
}

// ── SemVer helpers ───────────────────────────────────────────────────────────

/// Parse a possibly package-prefixed `SemVer` tag into
/// `(major, minor, patch, is_prerelease)`, or `None` if it is not `SemVer`.
///
/// Strips a monorepo `pkg-`/`pkg@`/`pkg/` prefix (e.g. `core-v1.2.3`,
/// `@acme/cli@2.0.0`) before parsing, mirroring the Python `_semver_parse`.
fn semver_parse(tag: &str) -> Option<(u64, u64, u64, bool)> {
    parse_semver_core(strip_pkg_prefix(tag))
}

/// Strip everything up to and including the rightmost `@`/`/`/`-` that is
/// immediately followed by an optional `v` and a `X.Y.Z` version.
fn strip_pkg_prefix(tag: &str) -> &str {
    let bytes = tag.as_bytes();
    for i in (0..bytes.len()).rev() {
        if matches!(bytes[i], b'@' | b'/' | b'-') {
            let rest = &tag[i + 1..];
            if starts_with_version(rest) {
                return rest;
            }
        }
    }
    tag
}

/// Whether `s` begins with `v?\d+\.\d+\.\d+` (the version-start lookahead).
fn starts_with_version(s: &str) -> bool {
    let mut rest = s.strip_prefix('v').unwrap_or(s);
    for i in 0..3 {
        let digits = rest.bytes().take_while(u8::is_ascii_digit).count();
        if digits == 0 {
            return false;
        }
        rest = &rest[digits..];
        if i < 2 {
            match rest.strip_prefix('.') {
                Some(r) => rest = r,
                None => return false,
            }
        }
    }
    true
}

/// Fully parse a version core `v?\d+\.\d+\.\d+(?:[-+].*)?`. The prerelease flag
/// is set when a `-` (not `+`) immediately follows `X.Y.Z`.
fn parse_semver_core(core: &str) -> Option<(u64, u64, u64, bool)> {
    let mut rest = core.strip_prefix('v').unwrap_or(core);
    let mut nums = [0u64; 3];
    for (i, slot) in nums.iter_mut().enumerate() {
        let digits = rest.bytes().take_while(u8::is_ascii_digit).count();
        if digits == 0 {
            return None;
        }
        *slot = rest[..digits].parse().ok()?;
        rest = &rest[digits..];
        if i < 2 {
            rest = rest.strip_prefix('.')?;
        }
    }
    let pre = match rest.chars().next() {
        None | Some('+') => false,
        Some('-') => true,
        Some(_) => return None, // trailing junk after X.Y.Z → not SemVer
    };
    Some((nums[0], nums[1], nums[2], pre))
}

/// Whether a manifest version string is `>=1.0` (`v?\d+\.` with major `>=1`).
fn version_ge_1_0(version: Option<&str>) -> bool {
    let Some(v) = version else {
        return false;
    };
    let s = v.strip_prefix('v').unwrap_or(v);
    let digits = s.bytes().take_while(u8::is_ascii_digit).count();
    // A leading number followed by a `.` — bare `1` (no dot) does not qualify.
    if digits == 0 || !s[digits..].starts_with('.') {
        return false;
    }
    s[..digits].parse::<u64>().is_ok_and(|n| n >= 1)
}

// ── Small helpers ────────────────────────────────────────────────────────────

/// Read a file through the [`Fs`] port as lossy UTF-8, capped at `limit`
/// *characters* (not bytes) — the Python `_read` opens in text mode, so
/// `fh.read(limit)` counts decoded characters. Slicing bytes instead would
/// under-read a multibyte README (a 4000-byte cap holds only ~1333 CJK chars)
/// and could split a codepoint into a `U+FFFD`. `None` when the read fails.
fn read_text(fs: &dyn Fs, path: &Path, limit: usize) -> Option<String> {
    let bytes = fs.read(path).ok()?;
    Some(
        String::from_utf8_lossy(&bytes)
            .chars()
            .take(limit)
            .collect(),
    )
}

/// Count non-blank lines (git shortlog emits one per committer).
fn count_lines(text: String) -> usize {
    text.lines().filter(|l| !l.trim().is_empty()).count()
}

/// Truncate to at most `n` characters (not bytes) — the Python `[:n]` slice.
fn truncate_chars(s: &str, n: usize) -> String {
    s.chars().take(n).collect()
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::collections::{HashMap, HashSet};
    use std::path::PathBuf;

    // ── In-memory fakes for the ports ──────────────────────────────────────

    #[derive(Default)]
    struct FakeFs {
        files: HashMap<PathBuf, Vec<u8>>,
        dirs: HashSet<PathBuf>,
    }

    impl FakeFs {
        fn file(mut self, path: &str, contents: &str) -> Self {
            let p = PathBuf::from(path);
            // Register ancestor directories so `read_dir`/`is_dir` see them.
            let mut cur = p.parent();
            while let Some(dir) = cur {
                if dir.as_os_str().is_empty() {
                    break;
                }
                self.dirs.insert(dir.to_path_buf());
                cur = dir.parent();
            }
            self.files.insert(p, contents.as_bytes().to_vec());
            self
        }

        fn dir(mut self, path: &str) -> Self {
            self.dirs.insert(PathBuf::from(path));
            self
        }
    }

    impl Fs for FakeFs {
        fn read(&self, path: &Path) -> std::io::Result<Vec<u8>> {
            self.files
                .get(path)
                .cloned()
                .ok_or_else(|| std::io::Error::from(std::io::ErrorKind::NotFound))
        }
        fn exists(&self, path: &Path) -> bool {
            self.files.contains_key(path) || self.dirs.contains(path)
        }
        fn is_dir(&self, path: &Path) -> bool {
            self.dirs.contains(path)
        }
        fn is_file(&self, path: &Path) -> bool {
            self.files.contains_key(path)
        }
        fn read_dir(&self, dir: &Path) -> std::io::Result<Vec<String>> {
            if !self.dirs.contains(dir) {
                return Err(std::io::Error::from(std::io::ErrorKind::NotFound));
            }
            let mut names: Vec<String> = self
                .files
                .keys()
                .chain(self.dirs.iter())
                .filter(|p| p.parent() == Some(dir))
                .filter_map(|p| p.file_name().map(|n| n.to_string_lossy().into_owned()))
                .collect();
            names.sort();
            Ok(names)
        }
    }

    #[derive(Default)]
    struct FakeGit {
        work_tree: bool,
        head: Option<String>,
        shortlog_all: String,
        shortlog_recent: String,
        tags: Vec<String>,
    }

    impl GitRepo for FakeGit {
        fn head_commit(&self) -> std::io::Result<String> {
            self.head
                .clone()
                .ok_or_else(|| std::io::Error::from(std::io::ErrorKind::NotFound))
        }
        fn is_work_tree(&self) -> bool {
            self.work_tree
        }
        fn shortlog(&self, since: Option<&str>) -> std::io::Result<String> {
            if !self.work_tree {
                return Err(std::io::Error::from(std::io::ErrorKind::Other));
            }
            Ok(if since.is_some() {
                self.shortlog_recent.clone()
            } else {
                self.shortlog_all.clone()
            })
        }
        fn tags(&self) -> std::io::Result<Vec<String>> {
            if self.work_tree {
                Ok(self.tags.clone())
            } else {
                Err(std::io::Error::from(std::io::ErrorKind::Other))
            }
        }
        fn git_common_dir(&self) -> std::io::Result<PathBuf> {
            Ok(PathBuf::from("/repo/.git"))
        }
    }

    /// A git repo with `n` distinct committers total / recent and the given tags.
    fn git_with(total: usize, recent: usize, tags: &[&str]) -> FakeGit {
        let lines = |n: usize| {
            (0..n)
                .map(|i| format!("     3\tDev {i} <dev{i}@example.com>"))
                .collect::<Vec<_>>()
                .join("\n")
        };
        FakeGit {
            work_tree: true,
            head: Some("deadbeef".to_string()),
            shortlog_all: lines(total),
            shortlog_recent: lines(recent),
            tags: tags.iter().map(|t| (*t).to_string()).collect(),
        }
    }

    fn repo() -> &'static Path {
        Path::new("/repo")
    }

    // ── Empty / unborn repo ────────────────────────────────────────────────

    #[test]
    fn empty_repo_is_spike_binary() {
        let facts = gather(repo(), &FakeFs::default(), &FakeGit::default());
        assert!(!facts.is_git);
        assert!(!facts.has_commits);
        assert_eq!(facts.ecosystems, vec![Ecosystem::Binary]);
        assert!(facts.packages.is_empty());
        assert_eq!(facts.committers_total, 0);
        assert_eq!(facts.committers_recent_year, 0);
        assert!(facts.tags.is_empty());
        assert!(!facts.has_ci);
        assert_eq!(facts.dependency_bot, None);
        assert_eq!(facts.description, None);
        // No CI, no SemVer tag, <=1 committer → spike.
        assert!(facts.maturity_signals.spike);
        assert_eq!(facts.inferred_maturity, Maturity::Spike);
    }

    #[test]
    fn unborn_repo_has_no_commits() {
        // A work tree whose HEAD does not resolve (no commits yet): is_git true,
        // has_commits false, so no committers/tags are read.
        let git = FakeGit {
            work_tree: true,
            head: None,
            ..FakeGit::default()
        };
        let facts = gather(repo(), &FakeFs::default(), &git);
        assert!(facts.is_git);
        assert!(!facts.has_commits);
        assert_eq!(facts.committers_total, 0);
        assert!(facts.tags.is_empty());
    }

    // ── Ecosystem + manifest detection ─────────────────────────────────────

    #[test]
    fn cargo_package_name_version_description() {
        let cargo = "[package]\nname = \"rg\"\nversion = \"0.3.0\"\n\
                     description = \"a fast grep\"\n\n[dependencies]\nserde = \"1\"\n";
        let fs = FakeFs::default().file("/repo/Cargo.toml", cargo);
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.ecosystems, vec![Ecosystem::Rust]);
        assert_eq!(facts.packages.len(), 1);
        let p = &facts.packages[0];
        assert_eq!(p.ecosystem, Ecosystem::Rust);
        assert_eq!(p.manifest, "Cargo.toml");
        assert_eq!(p.package.as_deref(), Some("rg"));
        assert_eq!(p.version.as_deref(), Some("0.3.0"));
        assert_eq!(facts.description.as_deref(), Some("a fast grep"));
    }

    #[test]
    fn cargo_virtual_workspace_with_no_resolvable_member_keeps_null_entry() {
        // A virtual workspace whose only member manifest is absent falls back to
        // the null root entry: the repo is still rust, and the null-named entry
        // preserves today's signal rather than emitting nothing.
        let fs = FakeFs::default().file("/repo/Cargo.toml", "[workspace]\nmembers = [\"a\"]\n");
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.ecosystems, vec![Ecosystem::Rust]);
        assert_eq!(facts.packages.len(), 1);
        assert_eq!(facts.packages[0].manifest, "Cargo.toml");
        assert_eq!(facts.packages[0].package, None);
        assert_eq!(facts.packages[0].version, None);
    }

    #[test]
    fn cargo_virtual_workspace_enumerates_members() {
        // A virtual-workspace root + two members: one inherits the workspace
        // version (`version.workspace = true`), one pins its own literal version.
        let root = "[workspace]\nresolver = \"2\"\n\
                    members = [\"crates/core\", \"crates/cli\"]\n\n\
                    [workspace.package]\nversion = \"0.1.0\"\nedition = \"2021\"\n";
        let core = "[package]\nname = \"acme-core\"\nversion.workspace = true\n\
                    edition.workspace = true\ndescription = \"the core lib\"\n";
        let cli = "[package]\nname = \"acme-cli\"\nversion = \"2.3.4\"\n\
                   description = \"the cli\"\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/crates/core/Cargo.toml", core)
            .file("/repo/crates/cli/Cargo.toml", cli);
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.ecosystems, vec![Ecosystem::Rust]);
        assert_eq!(facts.packages.len(), 2);
        // Declaration order is preserved.
        let core_pkg = &facts.packages[0];
        assert_eq!(core_pkg.ecosystem, Ecosystem::Rust);
        assert_eq!(core_pkg.manifest, "crates/core/Cargo.toml");
        assert_eq!(core_pkg.package.as_deref(), Some("acme-core"));
        // `version.workspace = true` inherits 0.1.0 from [workspace.package].
        assert_eq!(core_pkg.version.as_deref(), Some("0.1.0"));
        let cli_pkg = &facts.packages[1];
        assert_eq!(cli_pkg.manifest, "crates/cli/Cargo.toml");
        assert_eq!(cli_pkg.package.as_deref(), Some("acme-cli"));
        assert_eq!(cli_pkg.version.as_deref(), Some("2.3.4"));
        // The description pass re-reads the first member manifest by its path.
        assert_eq!(facts.description.as_deref(), Some("the core lib"));
    }

    // ── rust_workspace graph (release-planner plumbing) ────────────────────────

    #[test]
    fn rust_workspace_graph_captures_lib_bin_edge() {
        // The canonical lib+bin shape: the bin pins the lib by exact version, the
        // exact `dep = { path, version = "=X" }` form `/oss-init` emits.
        let root = "[workspace]\nmembers = [\"crates/core\", \"crates/cli\"]\n\n\
                    [workspace.package]\nversion = \"0.1.6\"\n";
        let core = "[package]\nname = \"octl-core\"\nversion.workspace = true\n\
                    publish = true\n";
        let cli = "[package]\nname = \"orchestratectl\"\nversion.workspace = true\n\
                   publish = true\n\n[dependencies]\n\
                   octl-core = { path = \"../core\", version = \"=0.1.6\" }\n\
                   serde = \"1\"\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/crates/core/Cargo.toml", core)
            .file("/repo/crates/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("a members-bearing workspace");
        // Both members, in declaration order (planner applies the topo order).
        let names: Vec<_> = ws.members.iter().map(|m| m.package.as_str()).collect();
        assert_eq!(names, vec!["octl-core", "orchestratectl"]);
        // The lib has no intra-workspace deps; the bin depends on the lib only
        // (`serde` is an external crate, not a member, so it is not an edge).
        assert!(ws.members[0].workspace_deps.is_empty());
        assert_eq!(ws.members[1].workspace_deps, vec!["octl-core".to_string()]);
        assert_eq!(ws.members[0].version.as_deref(), Some("0.1.6"));
    }

    #[test]
    fn rust_workspace_graph_drops_unpublishable_members() {
        // `publish = false` and a non-crates.io registry restriction both exclude a
        // member from the publish set (matching the cargo adapter's metadata filter);
        // an edge to an excluded member is not an ordering edge.
        let root = "[workspace]\nmembers = [\"a\", \"b\", \"c\"]\n";
        let a = "[package]\nname = \"a\"\nversion = \"1.0.0\"\n"; // publishable (absent)
        let b = "[package]\nname = \"b\"\nversion = \"1.0.0\"\npublish = false\n";
        let c = "[package]\nname = \"c\"\nversion = \"1.0.0\"\n\
                 publish = [\"my-registry\"]\n\n[dependencies]\n\
                 b = { path = \"../b\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/a/Cargo.toml", a)
            .file("/repo/b/Cargo.toml", b)
            .file("/repo/c/Cargo.toml", c);
        let ws = detect_rust_workspace(repo(), &fs).expect("at least `a` is publishable");
        let names: Vec<_> = ws.members.iter().map(|m| m.package.as_str()).collect();
        assert_eq!(names, vec!["a"], "only the publishable member survives");
    }

    #[test]
    fn rust_workspace_graph_honors_crates_io_allow_list() {
        // `publish = ["crates-io"]` is publishable; the array form is not `publish = false`.
        let root = "[workspace]\nmembers = [\"a\"]\n";
        let a = "[package]\nname = \"a\"\nversion = \"1.0.0\"\n\
                 publish = [\"crates-io\"]\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/a/Cargo.toml", a);
        let ws = detect_rust_workspace(repo(), &fs).expect("crates-io allow-listed");
        assert_eq!(ws.members.len(), 1);
    }

    #[test]
    fn rust_workspace_graph_none_for_single_crate_repo() {
        // A single root crate (no `[workspace].members`) is not a multi-crate
        // workspace — the planner has nothing to expand.
        let cargo = "[package]\nname = \"solo\"\nversion = \"0.1.0\"\n";
        let fs = FakeFs::default().file("/repo/Cargo.toml", cargo);
        assert!(detect_rust_workspace(repo(), &fs).is_none());
    }

    #[test]
    fn rust_workspace_graph_dep_rename_via_inline_package_key() {
        // A renamed dependency (`alias = { package = "real-core" }`) resolves to the
        // real crate name, so the edge to the workspace member is still detected.
        let root = "[workspace]\nmembers = [\"core\", \"cli\"]\n";
        let core = "[package]\nname = \"real-core\"\nversion = \"1.0.0\"\n";
        let cli = "[package]\nname = \"cli\"\nversion = \"1.0.0\"\n\n[dependencies]\n\
                   alias = { package = \"real-core\", path = \"../core\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/core/Cargo.toml", core)
            .file("/repo/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let cli = ws
            .members
            .iter()
            .find(|m| m.package == "cli")
            .expect("cli member");
        assert_eq!(cli.workspace_deps, vec!["real-core".to_string()]);
    }

    #[test]
    fn rust_workspace_graph_ignores_registry_dep_sharing_a_member_name() {
        // A registry dependency (`shared = "1"`) is NEVER an intra-workspace edge, even
        // when a workspace member happens to be named `shared` — Cargo resolves it to
        // crates.io. Treating the name collision as an edge would invent a false
        // ordering constraint (and here a false cycle: cli↔shared).
        let root = "[workspace]\nmembers = [\"shared\", \"cli\"]\n";
        let shared = "[package]\nname = \"shared\"\nversion = \"1.0.0\"\n\n[dependencies]\n\
                      cli = { path = \"../cli\" }\n"; // shared really depends on cli
        let cli = "[package]\nname = \"cli\"\nversion = \"1.0.0\"\n\n[dependencies]\n\
                   shared = \"1\"\n"; // a crates.io `shared`, NOT the workspace member
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/shared/Cargo.toml", shared)
            .file("/repo/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let cli = ws.members.iter().find(|m| m.package == "cli").unwrap();
        let shared = ws.members.iter().find(|m| m.package == "shared").unwrap();
        assert!(
            cli.workspace_deps.is_empty(),
            "a registry dep sharing a member name is not an edge"
        );
        assert_eq!(
            shared.workspace_deps,
            vec!["cli".to_string()],
            "the real path edge is still detected"
        );
    }

    #[test]
    fn rust_workspace_graph_ignores_registry_inline_table_without_path() {
        // An inline table with only `version` is a crates.io dep, not a workspace edge.
        let root = "[workspace]\nmembers = [\"a\", \"b\"]\n";
        let a = "[package]\nname = \"a\"\nversion = \"1.0.0\"\n";
        let b = "[package]\nname = \"b\"\nversion = \"1.0.0\"\n\n[dependencies]\n\
                 a = { version = \"1\", features = [\"x\"] }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/a/Cargo.toml", a)
            .file("/repo/b/Cargo.toml", b);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let b = ws.members.iter().find(|m| m.package == "b").unwrap();
        assert!(
            b.workspace_deps.is_empty(),
            "an inline registry dep (no path/workspace) is not an edge"
        );
    }

    #[test]
    fn rust_workspace_graph_records_the_lockstep_pin_requirement() {
        // facet 3: an inline `= "=X"` pin's requirement is carried in dep_reqs so the
        // planner can rewrite only the exact lockstep edge.
        let root = "[workspace]\nmembers = [\"core\", \"cli\"]\n";
        let core = "[package]\nname = \"octl-core\"\nversion = \"0.4.0\"\n";
        let cli = "[package]\nname = \"cli\"\nversion = \"0.4.0\"\n\n[dependencies]\n\
                   octl-core = { path = \"../core\", version = \"=0.4.0\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/core/Cargo.toml", core)
            .file("/repo/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let cli = ws.members.iter().find(|m| m.package == "cli").unwrap();
        assert_eq!(cli.workspace_deps, vec!["octl-core".to_string()]);
        assert_eq!(
            cli.dep_reqs.get("octl-core").map(String::as_str),
            Some("=0.4.0")
        );
    }

    #[test]
    fn rust_workspace_graph_omits_req_for_a_pathonly_edge() {
        // A path-only edge (no version) records the edge but no requirement, so the
        // planner emits no pin rewrite for it (fail closed — the publish would surface
        // a real error if a pin were needed).
        let root = "[workspace]\nmembers = [\"core\", \"cli\"]\n";
        let core = "[package]\nname = \"octl-core\"\nversion = \"0.4.0\"\n";
        let cli = "[package]\nname = \"cli\"\nversion = \"0.4.0\"\n\n[dependencies]\n\
                   octl-core = { path = \"../core\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/core/Cargo.toml", core)
            .file("/repo/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let cli = ws.members.iter().find(|m| m.package == "cli").unwrap();
        assert_eq!(cli.workspace_deps, vec!["octl-core".to_string()]);
        assert!(!cli.dep_reqs.contains_key("octl-core"));
    }

    #[test]
    fn rust_workspace_graph_reads_target_specific_dependency_edges() {
        // A `[target.'cfg(...)'.dependencies]` normal dep gates publish order too —
        // crates.io validates it at `cargo publish`.
        let root = "[workspace]\nmembers = [\"core\", \"cli\"]\n";
        let core = "[package]\nname = \"octl-core\"\nversion = \"1.0.0\"\n";
        let cli = "[package]\nname = \"cli\"\nversion = \"1.0.0\"\n\n\
                   [target.'cfg(unix)'.dependencies]\n\
                   octl-core = { path = \"../core\", version = \"=1.0.0\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/core/Cargo.toml", core)
            .file("/repo/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let cli = ws.members.iter().find(|m| m.package == "cli").unwrap();
        assert_eq!(cli.workspace_deps, vec!["octl-core".to_string()]);
    }

    #[test]
    fn rust_workspace_graph_reads_subtable_path_edge_and_rename() {
        // `[dependencies.<name>]` sub-table with a `path` is a local edge; a `package`
        // key inside renames it. A version-only sub-table is NOT an edge.
        let root = "[workspace]\nmembers = [\"core\", \"cli\"]\n";
        let core = "[package]\nname = \"real-core\"\nversion = \"1.0.0\"\n";
        let cli = "[package]\nname = \"cli\"\nversion = \"1.0.0\"\n\n\
                   [dependencies.alias]\npackage = \"real-core\"\npath = \"../core\"\n\
                   version = \"=1.0.0\"\n\n\
                   [dependencies.serde]\nversion = \"1\"\n"; // registry sub-table, not an edge
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/core/Cargo.toml", core)
            .file("/repo/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let cli = ws.members.iter().find(|m| m.package == "cli").unwrap();
        assert_eq!(
            cli.workspace_deps,
            vec!["real-core".to_string()],
            "the renamed path sub-table is the only edge; the version-only one is not"
        );
    }

    #[test]
    fn rust_workspace_graph_reads_dotted_key_path_edge() {
        // Dotted-key form: `dep.path = "..."` (and `dep.workspace = true`) are local
        // edges; a lone `dep.version` is not.
        let root = "[workspace]\nmembers = [\"core\", \"cli\"]\n";
        let core = "[package]\nname = \"core\"\nversion = \"1.0.0\"\n";
        let cli = "[package]\nname = \"cli\"\nversion = \"1.0.0\"\n\n[dependencies]\n\
                   core.path = \"../core\"\ncore.version = \"=1.0.0\"\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/core/Cargo.toml", core)
            .file("/repo/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let cli = ws.members.iter().find(|m| m.package == "cli").unwrap();
        assert_eq!(cli.workspace_deps, vec!["core".to_string()]);
    }

    #[test]
    fn rust_workspace_graph_dep_rename_ignores_package_substring_in_a_path() {
        // A path value that literally contains "package" must NOT be misread as a
        // `package = ` rename key: the edge stays on the bare key `octl-core`.
        let root = "[workspace]\nmembers = [\"core\", \"cli\"]\n";
        let core = "[package]\nname = \"octl-core\"\nversion = \"1.0.0\"\n";
        let cli = "[package]\nname = \"cli\"\nversion = \"1.0.0\"\n\n[dependencies]\n\
                   octl-core = { path = \"../my-package-core\", version = \"1\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/core/Cargo.toml", core)
            .file("/repo/cli/Cargo.toml", cli);
        // `octl-core` is not a member name here (the lib is named `octl-core`, the dep
        // key is `octl-core`) — assert the key resolves, not a spurious path substring.
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let cli = ws.members.iter().find(|m| m.package == "cli").unwrap();
        assert_eq!(cli.workspace_deps, vec!["octl-core".to_string()]);
    }

    #[test]
    fn rust_workspace_graph_reads_build_dependency_edges() {
        // A build-dependency on a workspace member gates publish order too.
        let root = "[workspace]\nmembers = [\"gen\", \"app\"]\n";
        let gen = "[package]\nname = \"gen\"\nversion = \"1.0.0\"\n";
        let app = "[package]\nname = \"app\"\nversion = \"1.0.0\"\n\n\
                   [build-dependencies]\ngen = { path = \"../gen\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/gen/Cargo.toml", gen)
            .file("/repo/app/Cargo.toml", app);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let app = ws.members.iter().find(|m| m.package == "app").unwrap();
        assert_eq!(app.workspace_deps, vec!["gen".to_string()]);
    }

    #[test]
    fn rust_workspace_graph_excludes_dev_dependency_edges() {
        // A dev-dependency never gates publish order (and can legitimately cycle:
        // a lib that dev-depends on the CLI for integration tests).
        let root = "[workspace]\nmembers = [\"lib\", \"cli\"]\n";
        let lib = "[package]\nname = \"lib\"\nversion = \"1.0.0\"\n\n\
                   [dev-dependencies]\ncli = { path = \"../cli\" }\n";
        let cli = "[package]\nname = \"cli\"\nversion = \"1.0.0\"\n\n[dependencies]\n\
                   lib = { path = \"../lib\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/lib/Cargo.toml", lib)
            .file("/repo/cli/Cargo.toml", cli);
        let ws = detect_rust_workspace(repo(), &fs).expect("workspace");
        let lib = ws.members.iter().find(|m| m.package == "lib").unwrap();
        let cli = ws.members.iter().find(|m| m.package == "cli").unwrap();
        assert!(
            lib.workspace_deps.is_empty(),
            "dev-dependency edge is not an ordering edge"
        );
        assert_eq!(cli.workspace_deps, vec!["lib".to_string()]);
    }

    #[test]
    fn cargo_workspace_inline_version_inheritance() {
        // The inline-table inheritance form `version = { workspace = true }`.
        let root = "[workspace]\nmembers = [\"m\"]\n\n\
                    [workspace.package]\nversion = \"1.5.0\"\n";
        let member = "[package]\nname = \"m\"\nversion = { workspace = true }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/m/Cargo.toml", member);
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.packages.len(), 1);
        assert_eq!(facts.packages[0].package.as_deref(), Some("m"));
        assert_eq!(facts.packages[0].version.as_deref(), Some("1.5.0"));
        // A member at >=1.0 (inherited) drives has_ge_1_0_release.
        assert!(facts.has_ge_1_0_release);
    }

    #[test]
    fn cargo_workspace_multiline_members_array() {
        // Members formatted across several lines (the common rustfmt layout).
        let root = "[workspace]\nmembers = [\n    \"a\",\n    \"b\",\n]\n\n\
                    [workspace.package]\nversion = \"0.2.0\"\n";
        let a = "[package]\nname = \"a\"\nversion.workspace = true\n";
        let b = "[package]\nname = \"b\"\nversion.workspace = true\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/a/Cargo.toml", a)
            .file("/repo/b/Cargo.toml", b);
        let facts = gather(repo(), &fs, &FakeGit::default());
        let names: Vec<_> = facts
            .packages
            .iter()
            .map(|p| p.package.as_deref())
            .collect();
        assert_eq!(names, vec![Some("a"), Some("b")]);
        assert!(facts
            .packages
            .iter()
            .all(|p| p.version.as_deref() == Some("0.2.0")));
    }

    #[test]
    fn cargo_workspace_member_without_workspace_package_table() {
        // `version.workspace = true` but no `[workspace.package]` to inherit from:
        // the version resolves to null (nothing to inherit), name still reported.
        let root = "[workspace]\nmembers = [\"m\"]\n";
        let member = "[package]\nname = \"m\"\nversion.workspace = true\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/m/Cargo.toml", member);
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.packages.len(), 1);
        assert_eq!(facts.packages[0].package.as_deref(), Some("m"));
        assert_eq!(facts.packages[0].version, None);
    }

    #[test]
    fn cargo_workspace_glob_members_are_expanded() {
        // `members = ["crates/*"]` expands one directory level, sorted, through the
        // Fs port. A non-crate entry (no Cargo.toml) is skipped.
        let root = "[workspace]\nmembers = [\"crates/*\"]\n\n\
                    [workspace.package]\nversion = \"0.4.0\"\n";
        let a = "[package]\nname = \"za\"\nversion.workspace = true\n";
        let b = "[package]\nname = \"mb\"\nversion.workspace = true\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/crates/za/Cargo.toml", a)
            .file("/repo/crates/mb/Cargo.toml", b)
            .file("/repo/crates/README.md", "not a crate\n");
        let facts = gather(repo(), &fs, &FakeGit::default());
        // Directory order is sorted (mb before za), not declaration order.
        let names: Vec<_> = facts
            .packages
            .iter()
            .map(|p| p.package.as_deref())
            .collect();
        assert_eq!(names, vec![Some("mb"), Some("za")]);
        assert_eq!(facts.packages[0].manifest, "crates/mb/Cargo.toml");
        assert!(facts
            .packages
            .iter()
            .all(|p| p.version.as_deref() == Some("0.4.0")));
    }

    #[test]
    fn cargo_workspace_exclude_and_dedup() {
        // A glob and an explicit member overlap (dedup to one entry); `exclude`
        // drops a matched member.
        let root = "[workspace]\nmembers = [\"crates/*\", \"crates/a\"]\n\
                    exclude = [\"crates/b\"]\n\n\
                    [workspace.package]\nversion = \"0.1.0\"\n";
        let a = "[package]\nname = \"a\"\nversion.workspace = true\n";
        let b = "[package]\nname = \"b\"\nversion.workspace = true\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/crates/a/Cargo.toml", a)
            .file("/repo/crates/b/Cargo.toml", b);
        let facts = gather(repo(), &fs, &FakeGit::default());
        // `b` excluded; `a` matched by both the glob and the explicit entry → once.
        let names: Vec<_> = facts
            .packages
            .iter()
            .map(|p| p.package.as_deref())
            .collect();
        assert_eq!(names, vec![Some("a")]);
    }

    #[test]
    fn cargo_workspace_commented_out_member_is_ignored() {
        // A commented-out member line must not be emitted, even if the path exists.
        let root = "[workspace]\nmembers = [\n    \"a\",\n    # \"b\",\n]\n\n\
                    [workspace.package]\nversion = \"0.1.0\"\n";
        let a = "[package]\nname = \"a\"\nversion.workspace = true\n";
        let b = "[package]\nname = \"b\"\nversion.workspace = true\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/a/Cargo.toml", a)
            .file("/repo/b/Cargo.toml", b);
        let facts = gather(repo(), &fs, &FakeGit::default());
        let names: Vec<_> = facts
            .packages
            .iter()
            .map(|p| p.package.as_deref())
            .collect();
        assert_eq!(names, vec![Some("a")]);
    }

    #[test]
    fn cargo_workspace_rejects_escaping_member_paths() {
        // Absolute and `..` members are rejected (a fact detector reports only the
        // repo's own packages) → no member resolves → null root entry fallback.
        let root = "[workspace]\nmembers = [\"../outside\", \"/abs\"]\n";
        let outside = "[package]\nname = \"outside\"\nversion = \"9.9.9\"\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/outside/Cargo.toml", outside)
            .file("/abs/Cargo.toml", outside);
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.packages.len(), 1);
        assert_eq!(facts.packages[0].manifest, "Cargo.toml");
        assert_eq!(facts.packages[0].package, None);
    }

    #[test]
    fn cargo_workspace_inheritance_scoped_and_boolean_strict() {
        // `version.workspace = true` in `[package.metadata.*]` must NOT be read as
        // `[package].version` inheritance; and `= trueish` is not the bool `true`.
        let root = "[workspace]\nmembers = [\"m\", \"n\"]\n\n\
                    [workspace.package]\nversion = \"7.7.7\"\n";
        let m = "[package]\nname = \"m\"\n\n\
                 [package.metadata.tool]\nversion.workspace = true\n";
        let n = "[package]\nname = \"n\"\nversion.workspace = trueish\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/m/Cargo.toml", m)
            .file("/repo/n/Cargo.toml", n);
        let facts = gather(repo(), &fs, &FakeGit::default());
        // Neither inherits the workspace version.
        assert_eq!(facts.packages[0].package.as_deref(), Some("m"));
        assert_eq!(facts.packages[0].version, None);
        assert_eq!(facts.packages[1].package.as_deref(), Some("n"));
        assert_eq!(facts.packages[1].version, None);
    }

    #[test]
    fn cargo_workspace_inline_inheritance_rejects_false_positive() {
        // `version = { workspace = false, … }` must not inherit; a genuine
        // `{ workspace = true }` must.
        let root = "[workspace]\nmembers = [\"yes\", \"no\"]\n\n\
                    [workspace.package]\nversion = \"3.0.0\"\n";
        let yes = "[package]\nname = \"yes\"\nversion = { workspace = true }\n";
        let no = "[package]\nname = \"no\"\nversion = { workspace = false, path = \"x\" }\n";
        let fs = FakeFs::default()
            .file("/repo/Cargo.toml", root)
            .file("/repo/yes/Cargo.toml", yes)
            .file("/repo/no/Cargo.toml", no);
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.packages[0].version.as_deref(), Some("3.0.0"));
        assert_eq!(facts.packages[1].version, None);
    }

    #[test]
    fn package_json_parsed_and_go_mod_module() {
        let pkg = r#"{"name": "@acme/cli", "version": "2.0.0", "description": "cli"}"#;
        let fs = FakeFs::default()
            .file("/repo/package.json", pkg)
            .file("/repo/go.mod", "module github.com/acme/tool\n\ngo 1.22\n");
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.ecosystems, vec![Ecosystem::Node, Ecosystem::Go]);
        let node = facts
            .packages
            .iter()
            .find(|p| p.ecosystem == Ecosystem::Node)
            .unwrap();
        assert_eq!(node.package.as_deref(), Some("@acme/cli"));
        assert_eq!(node.version.as_deref(), Some("2.0.0"));
        let go = facts
            .packages
            .iter()
            .find(|p| p.ecosystem == Ecosystem::Go)
            .unwrap();
        assert_eq!(go.package.as_deref(), Some("github.com/acme/tool"));
        // package.json's description wins (first package with a description).
        assert_eq!(facts.description.as_deref(), Some("cli"));
    }

    #[test]
    fn pyproject_project_then_poetry_fallback() {
        let project = "[project]\nname = \"widget\"\nversion = \"1.4.0\"\n\
                       description = \"a widget\"\n";
        let facts = gather(
            repo(),
            &FakeFs::default().file("/repo/pyproject.toml", project),
            &FakeGit::default(),
        );
        assert_eq!(facts.packages[0].package.as_deref(), Some("widget"));
        assert_eq!(facts.packages[0].version.as_deref(), Some("1.4.0"));

        let poetry = "[tool.poetry]\nname = \"legacy\"\nversion = \"0.1.0\"\n";
        let facts = gather(
            repo(),
            &FakeFs::default().file("/repo/pyproject.toml", poetry),
            &FakeGit::default(),
        );
        assert_eq!(facts.packages[0].package.as_deref(), Some("legacy"));
    }

    #[test]
    fn pyproject_single_quoted_strings_parse() {
        // TOML literal (single-quoted) strings are valid and `tomllib` accepts
        // them; the scanner must too, or a >=1.0 release would be missed.
        let project = "[project]\nname = 'widget'\nversion = '1.2.0'\n\
                       description = 'a widget'\n";
        let facts = gather(
            repo(),
            &FakeFs::default().file("/repo/pyproject.toml", project),
            &FakeGit::default(),
        );
        assert_eq!(facts.packages[0].package.as_deref(), Some("widget"));
        assert_eq!(facts.packages[0].version.as_deref(), Some("1.2.0"));
        assert!(facts.has_ge_1_0_release);
        assert_eq!(facts.description.as_deref(), Some("a widget"));
    }

    #[test]
    fn toml_key_matches_whole_token_not_prefix() {
        // `version-code` / `namespace` must not satisfy the `version` / `name`
        // key match.
        let cargo = "[package]\nnamespace = \"nope\"\nversion-code = \"9\"\n\
                     name = \"real\"\nversion = \"0.2.0\"\n";
        let facts = gather(
            repo(),
            &FakeFs::default().file("/repo/Cargo.toml", cargo),
            &FakeGit::default(),
        );
        assert_eq!(facts.packages[0].package.as_deref(), Some("real"));
        assert_eq!(facts.packages[0].version.as_deref(), Some("0.2.0"));
    }

    #[test]
    fn setup_py_marks_python_but_adds_no_package() {
        let fs = FakeFs::default().file("/repo/setup.py", "from setuptools import setup\n");
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.ecosystems, vec![Ecosystem::Python]);
        assert!(facts.packages.is_empty());
    }

    #[test]
    fn ecosystems_emit_in_canonical_order() {
        // Files added out of order; output follows the MANIFESTS order.
        let fs = FakeFs::default().file("/repo/go.mod", "module x\n").file(
            "/repo/Cargo.toml",
            "[package]\nname = \"a\"\nversion = \"0.1.0\"\n",
        );
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.ecosystems, vec![Ecosystem::Rust, Ecosystem::Go]);
    }

    // ── CI / bot / issues signals ──────────────────────────────────────────

    #[test]
    fn workflows_dir_counts_only_when_non_empty() {
        // Empty workflows dir → no CI.
        let empty = FakeFs::default().dir("/repo/.github/workflows").file(
            "/repo/Cargo.toml",
            "[package]\nname=\"a\"\nversion=\"0.1.0\"\n",
        );
        assert!(!gather(repo(), &empty, &FakeGit::default()).has_ci);

        // A file inside it → CI present.
        let with_wf = FakeFs::default()
            .file("/repo/.github/workflows/ci.yml", "on: push\n")
            .file(
                "/repo/Cargo.toml",
                "[package]\nname=\"a\"\nversion=\"0.1.0\"\n",
            );
        assert!(gather(repo(), &with_wf, &FakeGit::default()).has_ci);
    }

    #[test]
    fn single_file_ci_configs_count_on_existence() {
        for name in [
            ".gitlab-ci.yml",
            "azure-pipelines.yml",
            ".drone.yml",
            "Jenkinsfile",
        ] {
            let fs = FakeFs::default().file(&format!("/repo/{name}"), "ci\n");
            assert!(
                gather(repo(), &fs, &FakeGit::default()).has_ci,
                "{name} should count as CI"
            );
        }
    }

    #[test]
    fn dependency_bot_and_issues_dir() {
        let dependabot = FakeFs::default().file("/repo/.github/dependabot.yml", "version: 2\n");
        assert_eq!(
            gather(repo(), &dependabot, &FakeGit::default()).dependency_bot,
            Some("dependabot".to_string())
        );
        let renovate = FakeFs::default().file("/repo/renovate.json", "{}\n");
        assert_eq!(
            gather(repo(), &renovate, &FakeGit::default()).dependency_bot,
            Some("renovate".to_string())
        );
        // dependabot takes precedence when both are present.
        let both = FakeFs::default()
            .file("/repo/.github/dependabot.yml", "version: 2\n")
            .file("/repo/renovate.json", "{}\n");
        assert_eq!(
            gather(repo(), &both, &FakeGit::default()).dependency_bot,
            Some("dependabot".to_string())
        );
        let issues = FakeFs::default().dir("/repo/issues");
        assert!(gather(repo(), &issues, &FakeGit::default()).has_issues_dir);
    }

    // ── README self-label + description fallback ───────────────────────────

    #[test]
    fn readme_self_label_and_prose_description() {
        let readme = "# My Tool\n\n> a quote\n\nStatus: private, early. Not much yet.\n";
        let fs = FakeFs::default().file("/repo/README.md", readme);
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.readme_self_label.as_deref(), Some("spike"));
        // First non-heading, non-`!`, non-`>` line.
        assert_eq!(
            facts.description.as_deref(),
            Some("Status: private, early. Not much yet.")
        );
    }

    #[test]
    fn description_truncates_to_120_chars() {
        let long = "x".repeat(200);
        let fs = FakeFs::default().file("/repo/README.md", &format!("intro\n{long}\n"));
        let facts = gather(repo(), &fs, &FakeGit::default());
        // "intro" is the first prose line; assert truncation on a long manifest
        // description instead to exercise the cap.
        let cargo = format!("[package]\nname=\"a\"\nversion=\"0.1.0\"\ndescription=\"{long}\"\n");
        let fs2 = FakeFs::default().file("/repo/Cargo.toml", &cargo);
        let facts2 = gather(repo(), &fs2, &FakeGit::default());
        assert_eq!(facts.description.as_deref(), Some("intro"));
        // Count characters, not bytes — the cap is a char cap.
        assert_eq!(
            facts2.description.as_deref().map(|d| d.chars().count()),
            Some(120)
        );
    }

    #[test]
    fn read_limit_counts_chars_not_bytes() {
        // A multibyte description right at the boundary: a byte-slice cap would
        // truncate/corrupt it; the char cap keeps it whole. `く` is 3 bytes.
        let desc = "く".repeat(60); // 60 chars, 180 bytes — under the 120 char cap
        let cargo = format!("[package]\nname=\"a\"\nversion=\"0.1.0\"\ndescription=\"{desc}\"\n");
        let fs = FakeFs::default().file("/repo/Cargo.toml", &cargo);
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert_eq!(facts.description.as_deref(), Some(desc.as_str()));
        // No replacement character crept in from a mid-codepoint byte slice.
        assert!(!facts.description.as_deref().unwrap().contains('\u{FFFD}'));
    }

    // ── SemVer tag handling ────────────────────────────────────────────────

    #[test]
    fn semver_parse_plain_prefixed_and_prerelease() {
        assert_eq!(semver_parse("v1.2.3"), Some((1, 2, 3, false)));
        assert_eq!(semver_parse("1.2.3"), Some((1, 2, 3, false)));
        assert_eq!(semver_parse("core-v1.2.3"), Some((1, 2, 3, false)));
        assert_eq!(semver_parse("@acme/cli@2.0.0"), Some((2, 0, 0, false)));
        assert_eq!(semver_parse("1.2.3-rc1"), Some((1, 2, 3, true)));
        assert_eq!(semver_parse("1.2.3+build"), Some((1, 2, 3, false)));
        assert_eq!(semver_parse("nightly"), None);
        assert_eq!(semver_parse("1.2"), None);
        assert_eq!(semver_parse("1.2.3.4"), None);
    }

    #[test]
    fn ge_1_0_release_from_tag_but_not_from_prerelease() {
        let fs = FakeFs::default().file(
            "/repo/Cargo.toml",
            "[package]\nname=\"a\"\nversion=\"0.9.0\"\n",
        );
        // A 1.0.0 tag → has_ge_1_0_release.
        let facts = gather(repo(), &fs, &git_with(1, 1, &["v0.9.0", "v1.0.0"]));
        assert!(facts.has_semver_tag);
        assert!(facts.has_ge_1_0_release);
        // Only a 1.0.0-rc prerelease tag → not a >=1.0 release.
        let fs2 = FakeFs::default().file(
            "/repo/Cargo.toml",
            "[package]\nname=\"a\"\nversion=\"0.9.0\"\n",
        );
        let facts2 = gather(repo(), &fs2, &git_with(1, 1, &["v1.0.0-rc1"]));
        assert!(facts2.has_semver_tag);
        assert!(!facts2.has_ge_1_0_release);
    }

    #[test]
    fn ge_1_0_release_from_manifest_version() {
        let fs = FakeFs::default().file(
            "/repo/Cargo.toml",
            "[package]\nname=\"a\"\nversion=\"1.4.0\"\n",
        );
        let facts = gather(repo(), &fs, &FakeGit::default());
        assert!(facts.has_ge_1_0_release);
    }

    #[test]
    fn version_ge_1_0_requires_dot_after_major() {
        assert!(version_ge_1_0(Some("1.0.0")));
        assert!(version_ge_1_0(Some("v2.3")));
        assert!(version_ge_1_0(Some("2024.1")));
        assert!(!version_ge_1_0(Some("0.9.9")));
        assert!(!version_ge_1_0(Some("1"))); // no dot
        assert!(!version_ge_1_0(None));
    }

    // ── Maturity truth table ───────────────────────────────────────────────

    #[test]
    fn production_needs_two_recent_committers_ge_1_0_and_ci() {
        let fs = FakeFs::default()
            .file(
                "/repo/Cargo.toml",
                "[package]\nname=\"a\"\nversion=\"1.2.0\"\n",
            )
            .file("/repo/.github/workflows/ci.yml", "on: push\n");
        let facts = gather(repo(), &fs, &git_with(4, 3, &["v1.2.0"]));
        assert!(facts.has_ci);
        assert!(facts.has_ge_1_0_release);
        assert!(facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Production);
    }

    #[test]
    fn mvp_when_ci_present_but_not_production_grade() {
        // Has CI (so not spike) but only one recent committer and no >=1.0.
        let fs = FakeFs::default()
            .file(
                "/repo/Cargo.toml",
                "[package]\nname=\"a\"\nversion=\"0.3.0\"\n",
            )
            .file("/repo/.github/workflows/ci.yml", "on: push\n");
        let facts = gather(repo(), &fs, &git_with(1, 1, &["v0.3.0"]));
        assert!(!facts.maturity_signals.production);
        assert!(!facts.maturity_signals.spike);
        assert_eq!(facts.inferred_maturity, Maturity::Mvp);
    }

    /// A `ZeroVer` repo with the full release process: CI + a dependency bot +
    /// `n` shipped `>=0.1.0` release tags. `bot` chooses the dependency-bot file.
    fn zerover_fs(bot: &str) -> FakeFs {
        FakeFs::default()
            .file(
                "/repo/Cargo.toml",
                "[package]\nname=\"a\"\nversion=\"0.6.0\"\n",
            )
            .file("/repo/.github/workflows/ci.yml", "on: push\n")
            .file(&format!("/repo/{bot}"), "version: 2\n")
    }

    #[test]
    fn pre_1_0_with_full_release_infra_is_production() {
        // A deliberately-0.x (ZeroVer) repo with a maintained release process: CI,
        // a dependency-update bot, ≥2 recent committers, and a release cadence of
        // two shipped ≥0.1.0 releases — but NO ≥1.0 release. It reaches
        // `production` via the ZeroVer path even though `has_ge_1_0_release` is
        // false.
        let fs = zerover_fs(".github/dependabot.yml");
        let facts = gather(repo(), &fs, &git_with(3, 3, &["v0.5.0", "v0.6.0"]));
        assert!(facts.has_ci);
        assert!(!facts.has_ge_1_0_release);
        assert_eq!(facts.dependency_bot.as_deref(), Some("dependabot"));
        assert!(facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Production);
    }

    #[test]
    fn renovate_unlocks_the_zerover_release_path() {
        // The ZeroVer path is bot-agnostic: a `renovate.json` unlocks it exactly
        // as `dependabot.yml` does.
        let fs = zerover_fs("renovate.json");
        let facts = gather(repo(), &fs, &git_with(2, 2, &["v0.1.0", "v0.2.0"]));
        assert_eq!(facts.dependency_bot.as_deref(), Some("renovate"));
        assert!(facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Production);
    }

    #[test]
    fn bare_0x_with_only_a_tag_is_not_production() {
        // The guard: a 0.x repo with ONLY a SemVer tag — no CI, no dependency
        // bot — must NOT inflate to `production`. It has a shipped tag and ≥2
        // recent committers, but the substantive signals (CI + a dep bot +
        // cadence) are absent.
        let fs = FakeFs::default().file(
            "/repo/Cargo.toml",
            "[package]\nname=\"a\"\nversion=\"0.6.0\"\n",
        );
        let facts = gather(repo(), &fs, &git_with(3, 3, &["v0.6.0"]));
        assert!(!facts.has_ci);
        assert!(!facts.has_ge_1_0_release);
        assert_eq!(facts.dependency_bot, None);
        assert!(!facts.maturity_signals.production);
        // Has a SemVer tag → not spike; the tie resolves to mvp.
        assert_eq!(facts.inferred_maturity, Maturity::Mvp);
    }

    #[test]
    fn zerover_v0_0_x_tag_is_not_a_shipped_release() {
        // The gaming guard: CI + a dep bot + ≥2 recent committers, but the only
        // tags are `0.0.x` — SemVer's initial-scratch space. Those are not
        // shipped releases, so the ZeroVer path stays closed → mvp. This blocks
        // the "empty workflow + empty dependabot.yml + `v0.0.1`" inflation.
        let fs = zerover_fs(".github/dependabot.yml");
        let facts = gather(repo(), &fs, &git_with(3, 3, &["v0.0.1", "v0.0.2"]));
        assert!(facts.has_ci);
        assert_eq!(facts.dependency_bot.as_deref(), Some("dependabot"));
        assert!(!facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Mvp);
    }

    #[test]
    fn pre_1_0_release_infra_requires_release_cadence() {
        // CI + a dep bot + ≥2 recent committers + a single shipped ≥0.1.0 tag →
        // one release is a moment, not a cadence → not production. Two shipped
        // releases are required, so a lone `git tag` can't unlock the path.
        let fs = zerover_fs(".github/dependabot.yml");
        let facts = gather(repo(), &fs, &git_with(3, 3, &["v0.1.0"]));
        assert!(!facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Mvp);
    }

    #[test]
    fn pre_1_0_release_infra_requires_dependency_bot() {
        // CI + a release cadence (two shipped tags) + ≥2 recent committers but NO
        // dependency bot → the ZeroVer path is incomplete → mvp. The dep bot is
        // the sole missing signal here, isolating its requirement.
        let fs = FakeFs::default()
            .file(
                "/repo/Cargo.toml",
                "[package]\nname=\"a\"\nversion=\"0.6.0\"\n",
            )
            .file("/repo/.github/workflows/ci.yml", "on: push\n");
        let facts = gather(repo(), &fs, &git_with(3, 3, &["v0.5.0", "v0.6.0"]));
        assert_eq!(facts.dependency_bot, None);
        assert!(!facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Mvp);
    }

    #[test]
    fn pre_1_0_release_infra_ignores_prerelease_tags_for_cadence() {
        // CI + a dep bot + ≥2 recent committers, but the tags are one shipped
        // release plus prereleases (`v0.6.0-rc1`, `v0.7.0-rc1`) → only one
        // non-prerelease ≥0.1.0 tag → no cadence → not production. Confirms
        // prereleases don't pad the shipped-release count.
        let fs = zerover_fs(".github/dependabot.yml");
        let facts = gather(
            repo(),
            &fs,
            &git_with(3, 3, &["v0.5.0", "v0.6.0-rc1", "v0.7.0-rc1"]),
        );
        assert!(facts.has_semver_tag);
        assert!(!facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Mvp);
    }

    #[test]
    fn pre_1_0_release_infra_requires_two_recent_committers() {
        // Full ZeroVer release evidence (CI + dep bot + cadence) but a single
        // recent committer → not production (solo maintenance).
        let fs = zerover_fs(".github/dependabot.yml");
        let facts = gather(repo(), &fs, &git_with(1, 1, &["v0.5.0", "v0.6.0"]));
        assert!(!facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Mvp);
    }

    #[test]
    fn ge_1_0_release_reaches_production_without_a_dependency_bot() {
        // Regression: the ≥1.0 path is unchanged — a ≥1.0 release + CI + ≥2
        // recent committers reaches production with NO dependency bot and no
        // cadence requirement. The bot asymmetry applies only below 1.0.
        let fs = FakeFs::default()
            .file(
                "/repo/Cargo.toml",
                "[package]\nname=\"a\"\nversion=\"1.2.0\"\n",
            )
            .file("/repo/.github/workflows/ci.yml", "on: push\n");
        let facts = gather(repo(), &fs, &git_with(2, 2, &["v1.2.0"]));
        assert!(facts.has_ge_1_0_release);
        assert_eq!(facts.dependency_bot, None);
        assert!(facts.maturity_signals.production);
        assert_eq!(facts.inferred_maturity, Maturity::Production);
    }

    #[test]
    fn spike_forced_by_readme_label_even_with_multiple_committers() {
        // No CI, no SemVer tag, but 3 committers — the README label flips spike.
        let fs = FakeFs::default()
            .file(
                "/repo/Cargo.toml",
                "[package]\nname=\"a\"\nversion=\"0.1.0\"\n",
            )
            .file(
                "/repo/README.md",
                "# X\n\nThis is an experimental prototype.\n",
            );
        let facts = gather(repo(), &fs, &git_with(3, 3, &[]));
        assert_eq!(facts.readme_self_label.as_deref(), Some("spike"));
        assert!(facts.maturity_signals.spike);
        assert_eq!(facts.inferred_maturity, Maturity::Spike);
    }

    #[test]
    fn multi_committer_no_ci_no_label_is_mvp_not_spike() {
        // No CI, no tag, >1 committer, no label → spike's committer clause fails
        // → mvp (the tie-breaker).
        let fs = FakeFs::default().file(
            "/repo/Cargo.toml",
            "[package]\nname=\"a\"\nversion=\"0.1.0\"\n",
        );
        let facts = gather(repo(), &fs, &git_with(3, 2, &[]));
        assert!(!facts.maturity_signals.spike);
        assert_eq!(facts.inferred_maturity, Maturity::Mvp);
    }

    // ── Determinism ────────────────────────────────────────────────────────

    #[test]
    fn same_repo_same_facts() {
        let build = || {
            FakeFs::default()
                .file(
                    "/repo/Cargo.toml",
                    "[package]\nname=\"a\"\nversion=\"0.3.0\"\n",
                )
                .file("/repo/.github/workflows/ci.yml", "on: push\n")
        };
        let a = gather(repo(), &build(), &git_with(2, 2, &["v0.3.0"]));
        let b = gather(repo(), &build(), &git_with(2, 2, &["v0.3.0"]));
        assert_eq!(
            serde_json::to_string(&a).unwrap(),
            serde_json::to_string(&b).unwrap()
        );
    }
}