cargo-rail: refactored monolith config, unify_analyzer, and fixed error reporting for JSON.

Author: loadingalias

.gitignore

@@ -21,10 +21,11 @@ AGENTS.md
 *.key
 
 # Documentation
-docs/*
-final_testing.md
+docs/design
+docs/src
 rules.md
-
+cmd_cfg.md
+v1_precheck.md
 
 # Cargo-Rail (Testing)
 *rail.toml

README.md

@@ -179,28 +179,29 @@ def456 fix: critical bug      # Same SHA!
 
 ## Configuration
 
-Create `.config/rail.toml`:
+Create `.config/rail.toml` (or use `cargo rail init`):
 
 ```toml
-# Toolchain management
-[toolchain]
-channel = "stable"
-components = ["clippy", "rustfmt"]
+# Target platforms for multi-target analysis (auto-detected by init)
+targets = ["x86_64-unknown-linux-gnu", "aarch64-apple-darwin"]
 
 # Dependency unification
 [unify]
-consolidate_transitive_features = false  # Consolidate transitive deps
-transitive_feature_host = "auto"         # Smart auto-selection
-validate_targets = []
+pin_transitives = true       # Pin transitive-only deps (workspace-hack replacement)
+transitive_host = "root"     # Where to put pinned dev-deps: "root" or "crates/foo"
+include_renamed = false      # Include package = "..." renamed deps
+exclude = ["openssl"]        # Deps to exclude from unification
 
-# Split/sync (optional)
-[[splits]]
-name = "my-crate"
+# Per-crate configuration (optional)
+[crates.my-crate.split]
 remote = "[email protected]:org/my-crate.git"
 mode = "single"
+
+[crates.my-crate.release]
+publish = true
 ```
 
-See [`.config/rail.toml.example`](.config/rail.toml.example) for all options.
+Run `cargo rail init --check` to preview generated config.
 
 ---
 

docs/book.toml

@@ -0,0 +1,34 @@
+[book]
+title = "cargo-rail Documentation"
+authors = ["loadingalias"]
+description = "Graph-aware workspace orchestration for Rust monorepos"
+language = "en"
+multilingual = false
+src = "src"
+
+[rust]
+edition = "2024"
+
+[build]
+build-dir = "book"
+create-missing = false
+
+[preprocessor.open-on-gh]
+command = "mdbook-open-on-gh"
+renderer = ["html"]
+
+[preprocessor.alerts]
+# Adds GitHub Flavored Markdown alerts support
+# Syntax: > [!NOTE], > [!TIP], > [!IMPORTANT], > [!WARNING], > [!CAUTION]
+
+[preprocessor.mermaid]
+command = "mdbook-mermaid"
+
+[output.html]
+git-repository-url = "https://github.com/loadingalias/cargo-rail"
+edit-url-template = "https://github.com/loadingalias/cargo-rail/edit/main/docs/src/{path}"
+additional-js = ["mermaid.min.js", "mermaid-init.js"]
+
+[output.html.fold]
+enable = true
+level = 0

src/cargo/manifest_ops.rs

@@ -14,7 +14,7 @@
 //! - **Bulk Operations** - transform multiple dependencies at once
 
 use crate::cargo::manifest_analyzer::DepKind;
-use crate::cargo::unify_analyzer::UnifiedDep;
+use crate::cargo::unify_types::UnifiedDep;
 use crate::error::{RailError, RailResult, ResultExt};
 use std::path::Path;
 use toml_edit::{Array, DocumentMut, InlineTable, Item, Table, Value};

src/cargo/manifest_writer.rs

@@ -4,7 +4,7 @@
 
 use crate::cargo::manifest_analyzer::DepKind;
 use crate::cargo::manifest_ops;
-use crate::cargo::unify_analyzer::{TransitivePin, UnifiedDep};
+use crate::cargo::unify_types::{TransitivePin, UnifiedDep};
 use crate::error::{RailResult, ResultExt};
 use crate::toml::format::TomlFormatter;
 use std::path::Path;

src/cargo/mod.rs

@@ -13,14 +13,18 @@ pub mod manifest_ops;
 pub mod manifest_writer;
 pub mod multi_target_metadata;
 pub mod unify_analyzer;
+pub mod unify_report;
+pub mod unify_types;
 
 // Re-export main types for convenience
 pub use cargo_transform::{CargoTransform, TransformContext};
 pub use feature_scanner::{FeatureScanResult, FeatureScanner};
 pub use manifest_analyzer::{DepKey, DepKind, DepUsage, ManifestAnalyzer};
 pub use manifest_writer::ManifestWriter;
 pub use multi_target_metadata::{ComputedMsrv, FragmentedTransitive, MultiTargetMetadata};
-pub use unify_analyzer::{
-  DuplicateCleanup, IssueSeverity, MemberEdit, PrunedFeature, TransitivePin, UnificationPlan, UnifiedDep,
-  UnifyAnalyzer, UnifyIssue, UnifyReport, ValidationResult,
+pub use unify_analyzer::UnifyAnalyzer;
+pub use unify_report::UnifyReport;
+pub use unify_types::{
+  DuplicateCleanup, IssueSeverity, MemberEdit, PrunedFeature, TransitivePin, UnificationPlan, UnifiedDep, UnifyIssue,
+  UnusedDep, UnusedReason, ValidationResult, VersionMismatch,
 };