Merge pull request #29 from StrangeDaysTech/feat/eliminate-scripts

feat: eliminate legacy scripts, add validate --staged and devtrail new

Author: montfort

CLAUDE.md

@@ -2,7 +2,7 @@
 
 This is the DevTrail project repository. It contains two main components:
 
-- **Framework** (`dist/`): documentation templates, governance policies, agent directives, and scripts
+- **Framework** (`dist/`): documentation templates, governance policies, and agent directives
 - **CLI** (`cli/`): the `devtrail` Rust binary that manages the framework in user projects
 
 ## Project Structure
@@ -12,7 +12,7 @@ devtrail/
 ├── cli/                    # Rust CLI source code
 │   ├── src/
 │   │   ├── main.rs         # Entry point, command routing
-│   │   ├── commands/       # Subcommands: init, update, remove, status, repair, validate, compliance, metrics, analyze, audit, explore, about
+│   │   ├── commands/       # Subcommands: init, update, remove, status, repair, validate, new, compliance, metrics, analyze, audit, explore, about
 │   │   ├── tui/            # Terminal UI for `explore` (ratatui + crossterm)
 │   │   ├── analysis_engine.rs # Code complexity analysis (arborist-metrics)
 │   │   ├── config.rs       # DevTrailConfig, Checksums, ComplexityConfig
@@ -176,7 +176,8 @@ Users can now run `devtrail update-framework` to get the new version.
 | `devtrail remove [--full]` | Remove DevTrail from project |
 | `devtrail status [path]` | Show installation health and doc stats |
 | `devtrail repair [path]` | Restore missing directories and framework files |
-| `devtrail validate [path]` | Validate documents for compliance and correctness |
+| `devtrail validate [path] [--staged]` | Validate documents for compliance and correctness |
+| `devtrail new [path] [-t type] [--title]` | Create a new DevTrail document from a template |
 | `devtrail compliance [path]` | Check regulatory compliance (EU AI Act, ISO 42001, NIST) |
 | `devtrail metrics [path]` | Show governance metrics and documentation statistics |
 | `devtrail analyze [path]` | Analyze code complexity (cognitive + cyclomatic metrics) |
@@ -198,7 +199,7 @@ cargo build --no-default-features  # Without TUI
 ### Test
 
 ```bash
-cargo test    # All 111 tests
+cargo test    # All 121 tests
 ```
 
 ### Feature Flags

CONTRIBUTING.md

@@ -89,8 +89,6 @@ Code contributions should:
 
 - **Git**
 - **A text editor** (VS Code recommended)
-- **Bash** (for Linux/Mac validation scripts)
-- **PowerShell** (for Windows validation scripts)
 - **Rust toolchain** (for CLI development — install via [rustup.rs](https://rustup.rs/))
 - **Node.js 20+** (optional, for markdownlint)
 
@@ -108,7 +106,7 @@ Code contributions should:
 
 3. **Install the pre-commit hook**
    ```bash
-   cp dist/scripts/pre-commit-docs.sh .git/hooks/pre-commit
+   echo 'devtrail validate --staged' > .git/hooks/pre-commit
    chmod +x .git/hooks/pre-commit
    ```
 
@@ -127,11 +125,7 @@ Code contributions should:
 
 6. **Make your changes and validate**
    ```bash
-   # Linux/Mac
-   bash dist/scripts/pre-commit-docs.sh
-
-   # Windows
-   .\dist\scripts\validate-docs.ps1
+   devtrail validate
    ```
 
 ---
@@ -140,7 +134,7 @@ Code contributions should:
 
 ### Before Submitting
 
-- [ ] Run validation scripts successfully
+- [ ] Run `devtrail validate` successfully
 - [ ] Update documentation if needed
 - [ ] Add yourself to CONTRIBUTORS.md (if applicable)
 - [ ] Write a clear PR description
@@ -184,7 +178,7 @@ Why is this change needed?
 How were these changes tested?
 
 ## Checklist
-- [ ] Validation scripts pass
+- [ ] `devtrail validate` passes
 - [ ] Documentation updated
 - [ ] No sensitive information included
 ```
@@ -257,8 +251,7 @@ If you're proposing a new document type:
    - `dist/dist-templates/directives/` (distribution templates)
 
 4. **Update validation**
-   - `dist/scripts/pre-commit-docs.sh`
-   - `dist/scripts/validate-docs.ps1`
+   - Add the new type to the CLI validation logic (`cli/src/commands/validate.rs`)
    - `dist/.github/workflows/docs-validation.yml`
 
 5. **Document the change**

README.md

@@ -146,7 +146,7 @@ DevTrail uses independent version tags for each component:
 
 | Component | Tag prefix | Example | Includes |
 |-----------|-----------|---------|----------|
-| Framework | `fw-` | `fw-4.0.0` | Templates (12 types), governance, directives, scripts |
+| Framework | `fw-` | `fw-4.0.0` | Templates (12 types), governance, directives |
 | CLI | `cli-` | `cli-2.1.0` | The `devtrail` binary |
 
 Check installed versions with `devtrail status` or `devtrail about`.
@@ -184,7 +184,7 @@ unzip devtrail-fw-*.zip -d your-project/
 cd your-project
 
 # Commit
-git add .devtrail/ DEVTRAIL.md scripts/
+git add .devtrail/ DEVTRAIL.md
 git commit -m "chore: adopt DevTrail"
 ```
 
@@ -319,18 +319,15 @@ concerns:
 
 ```bash
 # Install the pre-commit hook
-cp scripts/pre-commit-docs.sh .git/hooks/pre-commit
+echo 'devtrail validate --staged' > .git/hooks/pre-commit
 chmod +x .git/hooks/pre-commit
 ```
 
 ### Manual Validation
 
 ```bash
-# Linux/Mac
-bash scripts/pre-commit-docs.sh
-
-# Windows PowerShell
-.\scripts\validate-docs.ps1
+# Cross-platform (any OS with devtrail installed)
+devtrail validate
 ```
 
 ### GitHub Actions
@@ -380,22 +377,21 @@ DevTrail includes skills for AI agents that enable **active documentation creati
 /devtrail-adr
 ```
 
-### Shell Scripts (Manual Use)
+### CLI Commands (Manual Use)
 
-For users who prefer command-line or use agents without skill support:
+For users who prefer the command line or use agents without skill support:
 
 ```bash
 # Interactive document creation
-./scripts/devtrail-new.sh
+devtrail new
 
 # Create specific type directly
-./scripts/devtrail-new.sh ailog
+devtrail new --doc-type ailog
 
 # Check documentation status
-./scripts/devtrail-status.sh
+devtrail status
 ```
 
-
 ### Agent Reporting
 
 AI agents report documentation status at the end of each task:
@@ -449,11 +445,11 @@ All skill implementations are **functionally identical**—only the format diffe
 
 ### Operating Systems
 
-| OS | Validation Script |
-|----|-------------------|
-| Linux | `scripts/pre-commit-docs.sh` |
-| macOS | `scripts/pre-commit-docs.sh` |
-| Windows | `scripts/validate-docs.ps1` |
+| OS | Validation |
+|----|------------|
+| Linux | `devtrail validate` |
+| macOS | `devtrail validate` |
+| Windows | `devtrail validate` |
 
 ### CI/CD Platforms
 

cli/src/commands/init.rs

@@ -70,7 +70,7 @@ pub fn run(path: &str) -> Result<()> {
     println!("    2. Check DEVTRAIL.md for governance rules");
     println!(
         "    3. Run {} to validate your setup",
-        "bash scripts/pre-commit-docs.sh".cyan()
+        "devtrail validate".cyan()
     );
     println!(
         "    4. Commit: {}",

cli/src/commands/mod.rs

@@ -7,6 +7,7 @@ pub mod compliance;
 pub mod explore;
 pub mod init;
 pub mod metrics;
+pub mod new;
 pub mod remove;
 pub mod repair;
 pub mod status;