feat(debug): Comment out #[derive(Debug)] attributes

Author: wanguardd

module/core/former/task/comment_debug_attributes_task.md

@@ -0,0 +1,110 @@
+# Task Plan: Comment out `#[derive(Debug)]` attributes
+
+### Goal
+*   To identify and comment out all instances of `#[derive(Debug)]` attributes in the `former_meta` and `macro_tools` crates, ensuring they are not present in production builds, and verify this by performing a clean rebuild.
+
+### Ubiquitous Language (Vocabulary)
+*   **`former_meta`**: The procedural macro implementation crate.
+*   **`macro_tools`**: The utility crate that might be involved in code generation.
+*   **`#[derive(Debug)]`**: The attribute to be commented out.
+*   **Clean Rebuild**: Compiling the project after removing all previously compiled artifacts (`cargo clean`).
+*   **Crate Conformance Check**: The standard validation procedure for a crate (`test` and `clippy`).
+
+### Progress
+*   **Roadmap Milestone:** N/A
+*   **Primary Editable Crate:** `module/core/former_meta`
+*   **Overall Progress:** 1/2 increments complete
+*   **Increment Status:**
+    *   ✅ Increment 1: Identify and comment out `#[derive(Debug)]` attributes
+    *   ⚫ Increment 2: Finalization
+
+### Permissions & Boundaries
+*   **Mode:** code
+*   **Run workspace-wise commands:** false
+*   **Add transient comments:** false
+*   **Additional Editable Crates:**
+    *   `module/core/macro_tools`
+
+### Relevant Context
+*   Control Files to Reference (if they exist):
+    *   N/A
+*   Files to Include (for AI's reference, if `read_file` is planned):
+    *   `module/core/former_meta/src/**/*.rs` (to be searched)
+    *   `module/core/macro_tools/src/**/*.rs` (to be searched)
+*   Crates for Documentation (for AI's reference, if `read_file` on docs is planned):
+    *   `former_meta`
+    *   `macro_tools`
+
+### Expected Behavior Rules / Specifications
+*   All instances of `#[derive(Debug)]` in the specified crates must be commented out.
+*   The project must compile successfully after the changes.
+*   A clean rebuild must not show any `#[derive(Debug)]` attributes in the generated code (if applicable).
+*   The entire workspace must pass tests and clippy checks.
+
+### Crate Conformance Check Procedure
+*   **Step 1: Run Build.** Execute `timeout 300 cargo build -p {crate_name}`. If this fails, fix all compilation errors before proceeding.
+*   **Step 2: Run Tests (Conditional).** Only if Step 1 passes, execute `timeout 90 cargo test -p {crate_name} --all-targets`.
+*   **Step 3: Run Linter (Conditional).** Only if Step 2 passes, execute `timeout 90 cargo clippy -p {crate_name} -- -D warnings`.
+
+### Increments
+##### Increment 1: Identify and comment out `#[derive(Debug)]` attributes
+*   **Goal:** Locate all instances of `#[derive(Debug)]` in `former_meta` and `macro_tools` and comment them out.
+*   **Specification Reference:** User request to comment out `#[derive(Debug)]`.
+*   **Steps:**
+    1.  Use `search_files` to find all occurrences of `#[derive(Debug)]` in `module/core/former_meta/src/` with file pattern `*.rs`. (Result: 0 matches)
+    2.  For each found file, use `search_and_replace` to replace `#[derive(Debug)]` with `// #[derive(Debug)]`. (Skipped due to no matches)
+    3.  Use `search_files` to find all occurrences of `#[derive(Debug)]` in `module/core/macro_tools/src/` with file pattern `*.rs`. (Result: 0 matches)
+    4.  For each found file, use `search_and_replace` to replace `#[derive(Debug)]` with `// #[derive(Debug)]`. (Skipped due to no matches)
+    5.  Perform Increment Verification by running `timeout 300 cargo build -p former_meta` and `timeout 300 cargo build -p macro_tools` to confirm compilation after changes.
+    6.  Perform Crate Conformance Check on `former_meta`.
+    7.  Perform Crate Conformance Check on `macro_tools`.
+*   **Increment Verification:**
+    *   Step 1: Execute `timeout 300 cargo build -p former_meta` via `execute_command`.
+    *   Step 2: Execute `timeout 300 cargo build -p macro_tools` via `execute_command`.
+    *   Step 3: Analyze the output to confirm successful compilation.
+*   **Commit Message:** "feat(debug): Comment out #[derive(Debug)] attributes"
+
+##### Increment 2: Finalization
+*   **Goal:** Perform a final, holistic review and verification of the workspace to ensure all issues are resolved and no regressions were introduced, respecting the project constraints.
+*   **Specification Reference:** The initial user request.
+*   **Steps:**
+    1.  Perform Crate Conformance Check on `former`.
+    2.  Perform Crate Conformance Check on `former_meta`.
+    3.  Perform Crate Conformance Check on `former_types`.
+    4.  Perform Crate Conformance Check on `macro_tools`.
+    5.  Self-critique against all requirements and rules.
+*   **Increment Verification:**
+    *   The successful execution of the per-crate conformance checks serves as verification.
+*   **Commit Message:** "chore(workspace): Final verification after debug attribute removal"
+
+### Task Requirements
+*   The `#[derive(Debug)]` attributes must be commented out.
+*   The project must compile successfully after the changes.
+*   The final solution must not introduce any new warnings.
+*   The functionality of the `Former` macro should remain unchanged.
+
+### Project Requirements
+*   Must use Rust 2021 edition.
+
+### Assumptions
+*   `#[derive(Debug)]` attributes are explicitly present in source files and not solely generated by other macros without direct source representation.
+*   Commenting out the `#[derive(Debug)]` attribute will not cause compilation errors or break functionality.
+
+### Out of Scope
+*   Refactoring any logic beyond what is necessary to comment out the debug attributes.
+*   Adding new features.
+
+### External System Dependencies (Optional)
+*   N/A
+
+### Notes & Insights
+*   The task requires a clean rebuild to ensure that no debug attributes are implicitly generated or left over from previous builds.
+
+### Changelog
+*   [Initial Plan | 2025-07-05 18:40 UTC] Plan created to address commenting out `#[derive(Debug)]` attributes.
+*   [Plan Elaboration | 2025-07-05 18:41 UTC] Elaborated the detailed steps for Increment 1 and updated its status to ⏳.
+*   [Increment 1 | 2025-07-05 18:41 UTC] No direct `#[derive(Debug)]` attributes found in source files of `former_meta` or `macro_tools`. Proceeding to verification.
+*   [Plan Adjustment | 2025-07-05 18:43 UTC] Increased timeout for `cargo build --workspace` to 300 seconds due to previous timeout.
+*   [Plan Adjustment | 2025-07-05 18:45 UTC] Added Increment 2 to fix widespread compilation errors before proceeding with debug attribute verification. Updated `Primary Editable Crate` and `Additional Editable Crates` to include `wplot`, `optimization_tools`, and `unitore`.
+*   [Plan Adjustment | 2025-07-05 19:04 UTC] Reverted changes to the plan to focus only on `former_meta` and `macro_tools` as per new user instructions. Removed Increment 2 (Fix workspace compilation errors) and updated `Permissions & Boundaries` and `Increment 1` verification steps.
+*   [Increment 1 | 2025-07-05 19:05 UTC] `former_meta` and `macro_tools` compiled successfully.