chore(repo): add git-cliff config, sort deps, add rust-version

- Add cliff.toml with GitHub remote wiring, issue link parsers, and
  clean group names (no sort prefixes)
- Add rust-version = "1.87.0" and codegen-units = 1 to workspace
- Sort workspace.dependencies alphabetically; add notstrap path entry
- Add CLAUDE.md preflight block; reformat workspace table to 100-col
- Delete stale brainstorm artifacts and root HANDOFF.md

.ctx/HANDOFF.md

@@ -1,4 +1,4 @@
-# Handoff — notfiles (2026-07-07)
+# Handoff — notfiles (2026-07-14)
 
 **Branch:** main | **Build:** unknown | **Tests:** unknown
 
@@ -11,6 +11,7 @@
 ## Log
 
 - 20260606.135918: done=13 running=0 pending=0 blocked=0
+- 2026-07-08: hexagonal architecture refactor with adapters and integration tests, notsecrets cleanup, config payload moved to notfiles-config repo
 - 2026-04-17: Added notnet crate with YubikeySource and threaded Tailscale into notstrap; design spec complete
 - 2026-04-15: Hardened bootstrap and hook-state failure handling, made notfiles FileStore usage real, and fixed copy-drift safety coverage
 - 2026-04-15: Pruned completed items from handoff; GitHub issues plus doob are now the source of truth for active work

.ctx/HANDOFF.notfiles.notfiles.yaml

@@ -1,6 +1,6 @@
 project: notfiles
 id: notfile
-updated: 2026-07-08
+updated: 2026-07-14
 items:
 - id: uncommitted-work
   doob_uuid: null
@@ -20,14 +20,12 @@ items:
   completed: null
   extra: []
 log:
-- date: 2026-07-08
-  summary: hexagonal architecture refactor with adapters and integration tests, notsecrets cleanup, config payload moved to notfiles-config repo
-  commits:
-  - 6427d18
-  - 25624c9
 - date: '20260606.135918'
   summary: done=13 running=0 pending=0 blocked=0
   commits: []
+- date: 2026-07-08
+  summary: hexagonal architecture refactor with adapters and integration tests, notsecrets cleanup, config payload moved to notfiles-config repo
+  commits: []
 - date: 2026-04-17
   summary: Added notnet crate with YubikeySource and threaded Tailscale into notstrap; design spec complete
   commits: []

.superpowers/brainstorm/72758-1776397235/content/architecture.html

@@ -1,71 +0,0 @@
-<h2>notfiles + Tailscale — Bootstrap Architecture</h2>
-<p class="subtitle">How the crates fit together for ephemeral machine setup</p>
-
-<div class="section">
-  <div style="background:#1a1a2e;border-radius:12px;padding:24px;font-family:monospace;font-size:13px;line-height:2;color:#e0e0e0;">
-
-    <div style="display:flex;gap:12px;align-items:flex-start;flex-wrap:wrap;">
-
-      <!-- Fresh machine -->
-      <div style="border:2px solid #4a9eff;border-radius:8px;padding:16px;min-width:160px;background:#0d1b2a;">
-        <div style="color:#4a9eff;font-weight:bold;margin-bottom:8px;">New Machine</div>
-        <div style="color:#aaa;font-size:12px;">TS_AUTHKEY env var</div>
-        <div style="color:#aaa;font-size:12px;">YubiKey (PIV slot 9d)</div>
-        <div style="color:#aaa;font-size:12px;">→ interactive prompt</div>
-      </div>
-
-      <div style="color:#888;font-size:20px;margin-top:28px;">→</div>
-
-      <!-- notstrap -->
-      <div style="border:2px solid #f0c040;border-radius:8px;padding:16px;min-width:160px;background:#1a1500;">
-        <div style="color:#f0c040;font-weight:bold;margin-bottom:8px;">notstrap</div>
-        <div style="color:#aaa;font-size:12px;">1. prereqs check</div>
-        <div style="color:#aaa;font-size:12px;">2. → <span style="color:#ff7eb3">notnet</span></div>
-        <div style="color:#aaa;font-size:12px;">3. clone Gitea</div>
-        <div style="color:#aaa;font-size:12px;">4. → <span style="color:#7effa0">notsecrets</span></div>
-        <div style="color:#aaa;font-size:12px;">5. link dotfiles</div>
-        <div style="color:#aaa;font-size:12px;">6. run hooks</div>
-      </div>
-
-      <div style="display:flex;flex-direction:column;gap:12px;margin-top:0;">
-
-        <div style="display:flex;align-items:center;gap:8px;">
-          <div style="color:#888;font-size:20px;">→</div>
-          <!-- notnet -->
-          <div style="border:2px solid #ff7eb3;border-radius:8px;padding:16px;min-width:160px;background:#1a0a14;">
-            <div style="color:#ff7eb3;font-weight:bold;margin-bottom:8px;">notnet <span style="color:#666;font-size:10px;">NEW</span></div>
-            <div style="color:#aaa;font-size:12px;">detect existing Tailscale</div>
-            <div style="color:#aaa;font-size:12px;">install if missing</div>
-            <div style="color:#aaa;font-size:12px;">resolve auth key</div>
-            <div style="color:#aaa;font-size:12px;">join tailnet</div>
-            <div style="color:#aaa;font-size:12px;">verify peer reachable</div>
-          </div>
-          <div style="color:#888;font-size:20px;">→</div>
-          <div style="border:2px solid #7effa0;border-radius:8px;padding:12px;min-width:120px;background:#001a08;">
-            <div style="color:#7effa0;font-weight:bold;margin-bottom:6px;">Tailnet</div>
-            <div style="color:#aaa;font-size:12px;">minibox (VPS)</div>
-            <div style="color:#aaa;font-size:12px;">Gitea repo</div>
-          </div>
-        </div>
-
-        <div style="display:flex;align-items:center;gap:8px;">
-          <div style="color:#888;font-size:20px;">→</div>
-          <!-- notsecrets -->
-          <div style="border:2px solid #7effa0;border-radius:8px;padding:16px;min-width:160px;background:#001a08;">
-            <div style="color:#7effa0;font-weight:bold;margin-bottom:8px;">notsecrets <span style="color:#666;font-size:10px;">+YubiKey</span></div>
-            <div style="color:#aaa;font-size:12px;">YubikeySource (PIV 9c)</div>
-            <div style="color:#aaa;font-size:12px;">BitwardenSource</div>
-            <div style="color:#aaa;font-size:12px;">FileSource</div>
-            <div style="color:#aaa;font-size:12px;">PromptSource</div>
-          </div>
-        </div>
-
-      </div>
-
-    </div>
-
-    <div style="margin-top:20px;padding-top:16px;border-top:1px solid #333;color:#888;font-size:11px;">
-      Already on Tailnet? notstrap detects active Tailscale → skips notnet entirely
-    </div>
-  </div>
-</div>

.superpowers/brainstorm/72758-1776397235/state/server-stopped

@@ -1 +0,0 @@
-{"reason":"idle timeout","timestamp":1776399095365}

.superpowers/brainstorm/72758-1776397235/state/server.log

@@ -1,3 +0,0 @@
-{"type":"server-started","port":63245,"host":"127.0.0.1","url_host":"localhost","url":"http://localhost:63245","screen_dir":"/Users/joe/dev/notfiles/.superpowers/brainstorm/72758-1776397235/content","state_dir":"/Users/joe/dev/notfiles/.superpowers/brainstorm/72758-1776397235/state"}
-{"type":"screen-added","file":"/Users/joe/dev/notfiles/.superpowers/brainstorm/72758-1776397235/content/architecture.html"}
-{"type":"server-stopped","reason":"idle timeout"}

.superpowers/brainstorm/72758-1776397235/state/server.pid

@@ -1 +0,0 @@
-72766

CLAUDE.md

@@ -1,5 +1,11 @@
 # CLAUDE.md
 
+<preflight>
+  Read: 
+    - @docs/DESIGN.md
+    - @.ctx/HANDOFF.md
+</preflight>
+
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
 ## What is notfiles?
@@ -24,19 +30,19 @@ cargo fmt --check                  # check formatting
 
 This is a Cargo workspace with 7 crates under `crates/`:
 
-| Crate        | Purpose                                                                    |
+| Crate        | Purpose                                                                 |
-| ------------ | -------------------------------------------------------------------------- |
+| ------------ | ----------------------------------------------------------------------- |
-| `notcore`    | Shared types: `Config`, `NotfilesError`, `Reporter`, `LinkEvent`,          |
+| `notcore`    | Shared types: `Config`, `NotfilesError`, `Reporter`, `LinkEvent`,       |
-|              | `expand_tilde`, `suggest_package`, `HookPhase`, `HookSpec`, `Report`       |
+|              | `expand_tilde`, `suggest_package`, `HookPhase`, `HookSpec`, `Report`    |
-| `notfiles`   | Dotfiles linker — lib + `notfiles` binary. Subcommands: `init`, `link`,    |
+| `notfiles`   | Dotfiles linker — lib + `notfiles` binary. Subcommands: `init`, `link`, |
-|              | `unlink`, `status`, `check`, `diff`, `adopt`, `completions`               |
+|              | `unlink`, `status`, `check`, `diff`, `adopt`, `completions`             |
-| `notsecrets` | Multi-provider secret resolution (`SecretResolver`), age encryption/       |
+| `notsecrets` | Multi-provider secret resolution (`SecretResolver`), age encryption/    |
-|              | decryption, identity management                                           |
+|              | decryption, identity management                                         |
-| `nothooks`   | Nushell hook runner with dot/setup phases and state persistence            |
+| `nothooks`   | Nushell hook runner with dot/setup phases and state persistence         |
-| `notnet`     | Network utilities — Tailscale integration, YubikeySource                   |
+| `notnet`     | Network utilities — Tailscale integration, YubikeySource                |
-| `notstrap`   | New-machine bootstrap orchestrator — ties all crates together              |
+| `notstrap`   | New-machine bootstrap orchestrator — ties all crates together           |
-| `notgraph`   | Dependency/import graph for Rust files — HTML/MD/JSON/Mermaid output,      |
+| `notgraph`   | Dependency/import graph for Rust files — HTML/MD/JSON/Mermaid output,   |
-|              | heatmap, cycle detection                                                   |
+|              | heatmap, cycle detection                                                |
 
 ## Architecture
 

Cargo.lock

@@ -1084,7 +1084,6 @@ dependencies = [
 name = "notcore"
 version = "0.1.0"
 dependencies = [
- "anyhow",
  "dirs",
  "serde",
  "strsim",
@@ -1114,9 +1113,7 @@ dependencies = [
 name = "notforge"
 version = "0.1.0"
 dependencies = [
- "anyhow",
  "base64",
- "clap",
  "miette",
  "notcore",
  "serde",
@@ -1173,7 +1170,6 @@ dependencies = [
  "bech32",
  "chacha20poly1305",
  "curve25519-dalek",
- "dirs",
  "ed25519-dalek",
  "hkdf",
  "hmac",
@@ -1188,7 +1184,6 @@ dependencies = [
  "toml",
  "x25519-dalek",
  "yubikey",
- "zeroize",
 ]
 
 [[package]]

Cargo.toml

@@ -5,6 +5,7 @@ homepage = "https://github.com/89jobrien/notfiles"
 keywords = ["dotfiles", "symlink", "stow", "config"]
 categories = ["command-line-utilities", "filesystem"]
 readme = "README.md"
+rust-version = "1.87.0"
 
 [workspace]
 members = [
@@ -22,31 +23,33 @@ resolver = "2"
 
 [workspace.dependencies]
 anyhow      = "1"
+assert_fs   = "1"
 base64      = "0.22"
+chrono      = { version = "0.4", default-features = false, features = ["clock"] }
 clap        = { version = "4", features = ["derive"] }
 clap_complete = "4"
-chrono      = { version = "0.4", default-features = false, features = ["clock"] }
 dirs        = "6"
 globset     = "0.4"
+miette      = { version = "7", features = ["derive"] }
+notcore     = { path = "crates/notcore" }
+notfiles    = { path = "crates/notfiles" }
+notforge    = { path = "crates/notforge" }
+nothooks    = { path = "crates/nothooks" }
+notnet      = { path = "crates/notnet" }
+notsecrets  = { path = "crates/notsecrets" }
+notstrap = { path = "crates/notstrap", version = "^0.1.0" } #unified
+rpassword   = "7"
 serde       = { version = "1", features = ["derive"] }
 serde_json  = "1"
 strsim      = "0.11"
+tempfile    = "3"
 thiserror   = "2"
 toml        = "0.8"
-miette      = { version = "7", features = ["derive"] }
 ureq        = { version = "2", features = ["json"] }
 which       = "7"
-rpassword   = "7"
-tempfile    = "3"
-assert_fs   = "1"
-notcore     = { path = "crates/notcore" }
-notfiles    = { path = "crates/notfiles" }
-notsecrets  = { path = "crates/notsecrets" }
-nothooks    = { path = "crates/nothooks" }
-notnet      = { path = "crates/notnet" }
-notforge    = { path = "crates/notforge" }
 
 [profile.release]
+codegen-units = 1
 opt-level = 3
 lto = "thin"
 strip = true

HANDOFF.md

@@ -1,24 +0,0 @@
-# HANDOFF.md
-
-Legacy note as of 2026-04-15.
-
-This repo no longer uses `HANDOFF.md` as a running history log.
-
-Active workflow:
-
-1. Sync GitHub issues into `doob`
-2. Read short-lived handoff context from `.ctx/HANDOFF.*.*.yaml`
-3. Update issue state in `doob`
-4. Sync `doob` back to GitHub issues
-
-Rules:
-
-- Handoff context should be brief and ephemeral
-- Only open work should appear in handoff files
-- Closed issues should be removed from handoff files after sync
-- Historical status belongs in GitHub issues and git history, not here
-
-Current state:
-
-- No open handoff items are tracked locally
-- Use GitHub issues plus `doob` as the task source of truth

cliff.toml

@@ -0,0 +1,93 @@
+# git-cliff ~ configuration file
+# https://git-cliff.org/docs/configuration
+
+[remote.github]
+owner = "89jobrien"
+repo  = "notfiles"
+
+[changelog]
+body = """
+{% if version %}\
+    ## {{ version | trim_start_matches(pat="v") }} - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## Unreleased
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | upper_first }}
+    {% for commit in commits %}
+        - {% if commit.scope %}**{{ commit.scope }}:** {% endif %}\
+          {{ commit.message | split(pat="\n") | first | upper_first | trim_end }}\
+          {% if commit.links %} \
+            ({% for link in commit.links %}[#{{ link.text }}]({{ link.href }}){% if not loop.last %}, {% endif %}{% endfor %})\
+          {% endif %}\
+    {% endfor %}
+{% endfor %}\n
+"""
+
+footer = """
+{%- macro remote_url() -%}
+  https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}
+{%- endmacro -%}
+
+{% for release in releases -%}
+    {% if release.version -%}
+        {% if release.previous.version -%}
+            [{{ release.version | trim_start_matches(pat="v") }}]: \
+                {{ self::remote_url() }}/compare/{{ release.previous.version }}...{{ release.version }}
+        {% endif -%}
+    {% else -%}
+        [unreleased]: {{ self::remote_url() }}/compare/{{ release.previous.version }}...HEAD
+    {% endif -%}
+{% endfor %}
+
+<!-- generated by git-cliff -->
+"""
+
+trim         = true
+render_always = true
+output       = "CHANGELOG.md"
+
+postprocessors = [
+    { pattern = '<REPO>', replace = "https://github.com/89jobrien/notfiles" },
+]
+
+
+[git]
+conventional_commits     = true
+filter_unconventional    = true
+require_conventional     = false
+split_commits            = false
+protect_breaking_commits = false
+filter_commits           = false
+fail_on_unmatched_commit = false
+use_branch_tags          = false
+topo_order               = false
+topo_order_commits       = true
+sort_commits             = "oldest"
+recurse_submodules       = false
+
+commit_preprocessors = [
+    { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "([#${2}](<REPO>/issues/${2}))" },
+]
+
+commit_parsers = [
+    { message = "^feat",                   group = "Features"          },
+    { message = "^fix",                    group = "Bug Fixes"         },
+    { message = "^refactor",               group = "Refactor"          },
+    { message = "^doc",                    group = "Documentation"     },
+    { message = "^perf",                   group = "Performance"       },
+    { message = "^style",                  group = "Styling"           },
+    { message = "^test",                   group = "Testing"           },
+    { message = "^chore\\(release\\):.*",  skip  = true                },
+    { message = "^chore\\(deps.*\\)",      skip  = true                },
+    { message = "^chore\\(pr\\)",          skip  = true                },
+    { message = "^chore\\(pull\\)",        skip  = true                },
+    { message = "^chore|^ci",             group = "Miscellaneous"     },
+    { body    = ".*security",             group = "Security"          },
+    { message = "^revert",                group = "Reverts"           },
+    { message = ".*",                     group = "Other"             },
+]
+
+link_parsers = [
+    { pattern = "#(\\d+)", href = "https://github.com/89jobrien/notfiles/issues/$1", text = "$1" },
+]

crates/notcore/Cargo.toml

@@ -10,7 +10,6 @@ categories.workspace = true
 description = "Shared types and config for the notfiles dotfiles manager"
 
 [dependencies]
-anyhow    = { workspace = true }
 dirs      = { workspace = true }
 serde     = { workspace = true }
 strsim    = { workspace = true }

crates/notforge/Cargo.toml

@@ -18,9 +18,7 @@ name = "notforge"
 path = "src/main.rs"
 
 [dependencies]
-anyhow = { workspace = true }
 base64 = { workspace = true }
-clap   = { workspace = true }
 miette = { workspace = true }
 notcore = { workspace = true }
 serde  = { workspace = true }

crates/notsecrets/Cargo.toml

@@ -10,7 +10,6 @@ base64           = "0.22"
 bech32           = "0.11"
 chacha20poly1305 = "0.10"
 curve25519-dalek = "4"
-dirs             = { workspace = true }
 ed25519-dalek    = "2"
 hkdf             = "0.12"
 hmac             = "0.12"
@@ -24,7 +23,6 @@ thiserror        = { workspace = true }
 toml             = { workspace = true }
 x25519-dalek     = { version = "2", features = ["static_secrets"] }
 yubikey          = { version = "0.8", optional = true }
-zeroize          = "1"
 
 [features]
 default = []

preflight.md

@@ -3,7 +3,7 @@
 A `rust-script` preflight that surfaces repo context in one shot: shell detection, git state,
 tracked-file tree, and HANDOFF document read/update.
 
-```rust
+````rust
 #!/usr/bin/env rust-script
 //! ```cargo
 //! [dependencies]
@@ -238,7 +238,7 @@ fn main() -> Result<()> {
     println!("\n{}", "╚══ done ══╝".bold().yellow());
     Ok(())
 }
-```
+````
 
 ## Usage
 
@@ -253,13 +253,13 @@ rust-script preflight.rs
 
 ## What it surfaces
 
-| Section | Details |
+| Section           | Details                                                                                                |
-|---------|---------|
+| ----------------- | ------------------------------------------------------------------------------------------------------ |
-| Environment | Current shell (`$SHELL`), cwd, git root |
+| Environment       | Current shell (`$SHELL`), cwd, git root                                                                |
-| Git status | Branch name, short status (clean or dirty file list) |
+| Git status        | Branch name, short status (clean or dirty file list)                                                   |
-| Git history | Last 7 commits, one-line with decoration |
+| Git history       | Last 7 commits, one-line with decoration                                                               |
-| Tracked file tree | `git ls-files` output rendered as an indented tree, depth ≤ 3 |
+| Tracked file tree | `git ls-files` output rendered as an indented tree, depth ≤ 3                                          |
-| HANDOFF docs | Full content (first 40 lines) of any `HANDOFF.*` file at repo root; stamps `last_preflight:` timestamp |
+| HANDOFF docs      | Full content (first 40 lines) of any `HANDOFF.*` file at repo root; stamps `last_preflight:` timestamp |
 
 ## Dependencies
 

tests/integration/Cargo.toml

@@ -3,7 +3,7 @@ name = "integration"
 version = "0.1.0"
 edition = "2024"
 license.workspace = true
-publish = false
+publish = true
 
 [[test]]
 name = "bootstrap"
@@ -16,9 +16,9 @@ path = "tests/cross_crate.rs"
 [dev-dependencies]
 anyhow    = { workspace = true }
 assert_fs = { workspace = true }
-notcore   = { path = "../../crates/notcore" }
+notcore = { workspace = true } #unified
-notfiles  = { path = "../../crates/notfiles" }
+notfiles = { workspace = true } #unified
-nothooks  = { path = "../../crates/nothooks" }
+nothooks = { workspace = true } #unified
-notsecrets = { path = "../../crates/notsecrets" }
+notsecrets = { workspace = true } #unified
-notstrap  = { path = "../../crates/notstrap" }
+notstrap = { workspace = true } #unified
 tempfile  = { workspace = true }