feat(nothooks): add phase-aware hook runner with setup-hook state tracking

crates/nothooks/src/lib.rs

@@ -1 +1,31 @@
-// placeholder
+pub mod runner;
+pub mod state;
+
+pub use runner::HookRunner;
+use notcore::{HookPhase, HookSpec, Report, StepStatus};
+
+#[derive(Debug, PartialEq)]
+pub enum HookResult {
+    Ok,
+    Skipped,
+    Failed(String),
+}
+
+/// Run all hooks matching `phase` and collect into a `Report`.
+pub fn run_phase(
+    hooks: &[HookSpec],
+    phase: &HookPhase,
+    runner: &HookRunner,
+) -> Report {
+    let mut report = Report::default();
+    for hook in hooks.iter().filter(|h| &h.phase == phase) {
+        let result = runner.run_hook(hook);
+        let status = match &result {
+            HookResult::Ok => StepStatus::Ok,
+            HookResult::Skipped => StepStatus::Skipped,
+            HookResult::Failed(msg) => StepStatus::Failed(msg.clone()),
+        };
+        report.add(&hook.name, status);
+    }
+    report
+}