feat: scaffold project with hooks, ignore, attributes, and config subcommands

Author: JheisonMB

.gitignore

@@ -11,4 +11,10 @@ Cargo.lock
 .kiro/
 .agents/
 .idea/
-skills-lock.json
+skills-lock.json
+
+# Added by cargo
+#
+# already existing elements were commented out
+
+#/target

Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "gitkit"
+version = "0.1.0"
+edition = "2021"
+description = "Standalone CLI for configuring git repos — hooks, .gitignore, and .gitattributes"
+license = "MIT"
+repository = "https://github.com/JheisonMB/gitkit"
+keywords = ["git", "hooks", "cli", "gitignore", "gitattributes"]
+categories = ["command-line-utilities", "development-tools"]
+
+[[bin]]
+name = "gitkit"
+path = "src/main.rs"
+
+[dependencies]
+anyhow = "1"
+clap = { version = "4", features = ["derive"] }
+ureq = "2"

src/attributes/mod.rs

@@ -0,0 +1,45 @@
+use anyhow::{Context, Result};
+use clap::Subcommand;
+use std::fs;
+
+use crate::utils::{confirm, find_repo_root};
+
+const PRESET: &str = "* text=auto eol=lf\n";
+
+#[derive(Subcommand)]
+pub enum AttributesCommand {
+    /// Apply line endings preset to .gitattributes
+    Init {
+        #[arg(short, long)]
+        yes: bool,
+        #[arg(short, long)]
+        force: bool,
+        #[arg(long)]
+        dry_run: bool,
+    },
+}
+
+pub fn run(cmd: AttributesCommand) -> Result<()> {
+    let AttributesCommand::Init {
+        yes,
+        force,
+        dry_run,
+    } = cmd;
+
+    let root = find_repo_root()?;
+    let path = root.join(".gitattributes");
+
+    if path.exists() && !force && !confirm(".gitattributes already exists. Overwrite?", yes) {
+        println!("Aborted.");
+        return Ok(());
+    }
+
+    if dry_run {
+        println!("[dry-run] Would write .gitattributes:\n{PRESET}");
+        return Ok(());
+    }
+
+    fs::write(&path, PRESET).context("Failed to write .gitattributes")?;
+    println!("Applied line endings preset to .gitattributes.");
+    Ok(())
+}

src/config/mod.rs

@@ -0,0 +1,132 @@
+use anyhow::{Context, Result};
+use clap::{Subcommand, ValueEnum};
+use std::process::Command;
+
+use crate::utils::confirm;
+
+#[derive(Subcommand)]
+pub enum ConfigCommand {
+    /// Apply a curated git config preset
+    Apply {
+        preset: Preset,
+        #[arg(short, long)]
+        yes: bool,
+        #[arg(long)]
+        dry_run: bool,
+    },
+}
+
+#[derive(ValueEnum, Clone)]
+pub enum Preset {
+    /// push.autoSetupRemote, help.autocorrect, diff.algorithm
+    Defaults,
+    /// merge.conflictstyle zdiff3, rerere.enabled (terminal-focused)
+    Advanced,
+    /// core.pager delta (installs git-delta if needed)
+    Delta,
+}
+
+pub fn run(cmd: ConfigCommand) -> Result<()> {
+    let ConfigCommand::Apply {
+        preset,
+        yes,
+        dry_run,
+    } = cmd;
+    match preset {
+        Preset::Defaults => apply_defaults(dry_run),
+        Preset::Advanced => apply_advanced(dry_run),
+        Preset::Delta => apply_delta(yes, dry_run),
+    }
+}
+
+type GitConfigs = &'static [(&'static str, &'static str)];
+
+const DEFAULTS: GitConfigs = &[
+    ("push.autoSetupRemote", "true"),
+    ("help.autocorrect", "prompt"),
+    ("diff.algorithm", "histogram"),
+];
+
+const ADVANCED: GitConfigs = &[
+    ("merge.conflictstyle", "zdiff3"),
+    ("rerere.enabled", "true"),
+];
+
+const DELTA_CONFIGS: GitConfigs = &[
+    ("core.pager", "delta"),
+    ("interactive.diffFilter", "delta --color-only"),
+    ("delta.navigate", "true"),
+    ("delta.side-by-side", "true"),
+];
+
+fn apply_defaults(dry_run: bool) -> Result<()> {
+    apply_configs(DEFAULTS, dry_run)
+}
+
+fn apply_advanced(dry_run: bool) -> Result<()> {
+    println!(
+        "Warning: merge.conflictstyle=zdiff3 may cause issues with GitHub Desktop and GUI merge tools."
+    );
+    apply_configs(ADVANCED, dry_run)
+}
+
+fn apply_delta(yes: bool, dry_run: bool) -> Result<()> {
+    if !delta_installed() {
+        if !confirm(
+            "git-delta is not installed. Install via `cargo install git-delta`?",
+            yes,
+        ) {
+            println!("Aborted.");
+            return Ok(());
+        }
+        if !dry_run {
+            install_delta()?;
+        } else {
+            println!("[dry-run] Would run: cargo install git-delta");
+        }
+    }
+    println!(
+        "Note: delta.side-by-side=true may look wrong in narrow terminals. \
+        Disable with: git config --global delta.side-by-side false"
+    );
+    apply_configs(DELTA_CONFIGS, dry_run)
+}
+
+fn apply_configs(configs: GitConfigs, dry_run: bool) -> Result<()> {
+    for (key, value) in configs {
+        if dry_run {
+            println!("[dry-run] git config --global {key} {value}");
+        } else {
+            git_config_set(key, value)?;
+            println!("Set {key} = {value}");
+        }
+    }
+    Ok(())
+}
+
+fn git_config_set(key: &str, value: &str) -> Result<()> {
+    let status = Command::new("git")
+        .args(["config", "--global", key, value])
+        .status()
+        .with_context(|| format!("Failed to run git config for '{key}'"))?;
+    anyhow::ensure!(status.success(), "git config --global {key} {value} failed");
+    Ok(())
+}
+
+fn delta_installed() -> bool {
+    Command::new("delta")
+        .arg("--version")
+        .output()
+        .map(|o| o.status.success())
+        .unwrap_or(false)
+}
+
+fn install_delta() -> Result<()> {
+    println!("Installing git-delta...");
+    let status = Command::new("cargo")
+        .args(["install", "git-delta"])
+        .status()
+        .context("Failed to run cargo install git-delta")?;
+    anyhow::ensure!(status.success(), "cargo install git-delta failed");
+    Ok(())
+}

src/hooks/builtins.rs

@@ -0,0 +1,39 @@
+pub(super) fn get(name: &str) -> Option<&'static str> {
+    match name {
+        "conventional-commits" => Some(CONVENTIONAL_COMMITS),
+        "no-secrets" => Some(NO_SECRETS),
+        "branch-naming" => Some(BRANCH_NAMING),
+        _ => None,
+    }
+}
+
+const CONVENTIONAL_COMMITS: &str = r#"#!/bin/sh
+commit_msg=$(cat "$1")
+pattern='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?: .{1,}'
+if ! echo "$commit_msg" | grep -qE "$pattern"; then
+  echo "ERROR: Commit message does not follow Conventional Commits format."
+  echo "Expected: <type>(<scope>): <description>"
+  echo "Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert"
+  exit 1
+fi
+"#;
+
+const NO_SECRETS: &str = r#"#!/bin/sh
+# Detects common secret patterns. Not exhaustive — use dedicated tools for production.
+patterns='(AKIA[0-9A-Z]{16}|AIza[0-9A-Za-z_-]{35}|ghp_[0-9A-Za-z]{36}|sk-[0-9A-Za-z]{48}|[0-9a-f]{40}|password\s*=\s*["\x27][^"\x27]{8,})'
+if git diff --cached --diff-filter=ACM | grep -qE "$patterns"; then
+  echo "ERROR: Possible secret detected in staged changes."
+  echo "Review your changes and remove any credentials before committing."
+  exit 1
+fi
+"#;
+
+const BRANCH_NAMING: &str = r#"#!/bin/sh
+branch=$(git symbolic-ref --short HEAD)
+pattern='^(main|master|develop|release/.+|hotfix/.+|feat/.+|fix/.+|chore/.+)$'
+if ! echo "$branch" | grep -qE "$pattern"; then
+  echo "ERROR: Branch name '$branch' does not match naming convention."
+  echo "Expected pattern: main|master|develop|release/*|hotfix/*|feat/*|fix/*|chore/*"
+  exit 1
+fi
+"#;