From 6427d188e664cd1f9f9b3f2b4dcb30deeb096a20 Mon Sep 17 00:00:00 2001
From: Joseph O'Brien <joseph.obrien@toptal.com>
Date: Wed, 8 Jul 2026 13:07:42 -0400
Subject: [PATCH] feat(notfiles): hexagonal architecture refactor with
 adapters, integration tests, and notsecrets cleanup

- Extract FileStore port and InMemoryFileStore/FileStoreImpl/Reporter adapters
- Add Reporter trait to notcore with TerminalReporter and JsonReporter
- Refactor linker, package, status modules to use FileStore port
- Add integration test suite with dotfiles fixtures
- Add cross-crate integration tests
- Remove ssh_rsa identity/recipient (unsupported)
- Add rustqual.toml, .sccignore, notfiles.toml config files
- Update CLAUDE.md, README.md, AGENTS.md with current architecture
---
 .DS_Store                                     | Bin 0 -> 10244 bytes
 .claude/.DS_Store                             | Bin 0 -> 6148 bytes
 .claude/settings.local.json                   |  27 ++
 .codex/hooks.json                             |  25 ++
 .ctx/HANDOFF.md                               |   4 +-
 .ctx/HANDOFF.notfiles.notfiles.yaml           |  29 +-
 .notfiles-state.toml                          |  76 +++++
 .sccignore                                    |  11 +
 .../brainstorm/72758-1776397235/.DS_Store     | Bin 0 -> 8196 bytes
 .../72758-1776397235/state/server-stopped     |   1 +
 AGENTS.md                                     | 110 +++++++
 CLAUDE.md                                     |  69 ++++-
 Cargo.lock                                    |  17 +-
 Cargo.toml                                    |   8 +
 README.md                                     |  64 +++-
 crates/.DS_Store                              | Bin 0 -> 8196 bytes
 crates/notcore/Cargo.toml                     |   6 +
 crates/notcore/src/config.rs                  | 161 ++++++++++
 crates/notcore/src/error.rs                   |   6 +
 crates/notcore/src/lib.rs                     |  10 +-
 crates/notcore/src/reporter.rs                |  46 +++
 crates/notfiles/.DS_Store                     | Bin 0 -> 6148 bytes
 crates/notfiles/Cargo.toml                    |   6 +
 crates/notfiles/src/adapters/memory.rs        | 293 ++++++++++++++++++
 crates/notfiles/src/adapters/mod.rs           |   4 +
 crates/notfiles/src/adapters/reporter.rs      |  81 +++++
 crates/notfiles/src/ignore.rs                 |   4 +-
 crates/notfiles/src/linker.rs                 | 274 +++++++++++-----
 crates/notfiles/src/package.rs                |  85 ++++-
 crates/notfiles/src/status.rs                 | 137 ++++++++
 .../tests/fixtures/dotfiles/README.md         |  23 ++
 .../.config/alacritty/alacritty.toml          |   2 +
 .../dotfiles/docs/bootstrap-runbook.md        |   3 +
 .../dotfiles/fish/.config/fish/config.fish    |   2 +
 .../tests/fixtures/dotfiles/git/.gitconfig    |   5 +
 .../dotfiles/mise/.config/mise/config.toml    |   2 +
 .../fixtures/dotfiles/nixos/configuration.nix |   4 +
 .../tests/fixtures/dotfiles/notfiles.toml     |  34 ++
 .../.config/nushell/autoload/aliases.nu       |   2 +
 .../nushell/.config/nushell/config.nu         |   2 +
 .../dotfiles/nushell/.config/nushell/env.nu   |   2 +
 .../tests/fixtures/dotfiles/scripts/doctor.sh |   3 +
 .../fixtures/dotfiles/scripts/lib/common.sh   |   3 +
 .../dotfiles/secrets/.env.json.example        |   3 +
 .../dotfiles/starship/.config/starship.toml   |   2 +
 .../Code/User/settings.json                   |   4 +
 .../tests/fixtures/dotfiles/zsh/.zshrc        |   2 +
 crates/notfiles/tests/integration.rs          | 161 ++++++++++
 crates/notgraph/.DS_Store                     | Bin 0 -> 6148 bytes
 crates/nothooks/.DS_Store                     | Bin 0 -> 6148 bytes
 crates/notsecrets/.DS_Store                   | Bin 0 -> 6148 bytes
 crates/notsecrets/Cargo.toml                  |   1 -
 crates/notsecrets/src/identities/mod.rs       |   3 -
 crates/notsecrets/src/identities/ssh_rsa.rs   | 110 -------
 crates/notsecrets/src/lib.rs                  |   8 +-
 crates/notsecrets/src/recipients/mod.rs       |   3 -
 crates/notsecrets/src/recipients/ssh_rsa.rs   |  38 ---
 docs/superpowers/.DS_Store                    | Bin 0 -> 6148 bytes
 notfiles.toml                                 |   7 +
 nushell/.DS_Store                             | Bin 0 -> 8196 bytes
 nushell/.config/.DS_Store                     | Bin 0 -> 8196 bytes
 nushell/.config/nushell/.DS_Store             | Bin 0 -> 6148 bytes
 rustqual.toml                                 |  99 ++++++
 tests/integration/tests/cross_crate.rs        | 127 ++++++++
 64 files changed, 1922 insertions(+), 287 deletions(-)
 create mode 100644 .DS_Store
 create mode 100644 .claude/.DS_Store
 create mode 100644 .claude/settings.local.json
 create mode 100644 .codex/hooks.json
 create mode 100644 .notfiles-state.toml
 create mode 100644 .sccignore
 create mode 100644 .superpowers/brainstorm/72758-1776397235/.DS_Store
 create mode 100644 .superpowers/brainstorm/72758-1776397235/state/server-stopped
 create mode 100644 AGENTS.md
 create mode 100644 crates/.DS_Store
 create mode 100644 crates/notcore/src/reporter.rs
 create mode 100644 crates/notfiles/.DS_Store
 create mode 100644 crates/notfiles/src/adapters/memory.rs
 create mode 100644 crates/notfiles/src/adapters/reporter.rs
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/README.md
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/alacritty/.config/alacritty/alacritty.toml
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/docs/bootstrap-runbook.md
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/fish/.config/fish/config.fish
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/git/.gitconfig
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/mise/.config/mise/config.toml
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/nixos/configuration.nix
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/notfiles.toml
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/autoload/aliases.nu
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/config.nu
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/env.nu
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/scripts/doctor.sh
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/scripts/lib/common.sh
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/secrets/.env.json.example
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/starship/.config/starship.toml
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/vscode/Library/Application Support/Code/User/settings.json
 create mode 100644 crates/notfiles/tests/fixtures/dotfiles/zsh/.zshrc
 create mode 100644 crates/notgraph/.DS_Store
 create mode 100644 crates/nothooks/.DS_Store
 create mode 100644 crates/notsecrets/.DS_Store
 delete mode 100644 crates/notsecrets/src/identities/ssh_rsa.rs
 delete mode 100644 crates/notsecrets/src/recipients/ssh_rsa.rs
 create mode 100644 docs/superpowers/.DS_Store
 create mode 100644 notfiles.toml
 create mode 100644 nushell/.DS_Store
 create mode 100644 nushell/.config/.DS_Store
 create mode 100644 nushell/.config/nushell/.DS_Store
 create mode 100644 rustqual.toml

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..ddc1af161c8e34234b0b63bdebaa5e173cb45caf
GIT binary patch
literal 10244
zcmeHMdu$xV8J}<C$F9A^8^<9RaKa@9LQ{+QkvKR&xY!OMFKlvl>^KnT?sgk5+1oX{
zdv}3gu&65D3E?l^0wmrdB2@zsl`7PhKoLb%8y<nGf6$^fpo*eas#+n^Z)Wz+yX(6Y
z36O%cEA4(e^Syra-S^GT%n?GMC#SX(5+{U+cvGs#_$YHxKD}pLg4dHk3aC#=j;KU4
zcDE-p)(q*WBZ@#2fhYn|1fmE;5jYbffZuF-iS?XD&nN;>1fmF(B0%SdINp>dJUYcG
zn>z5pwg5=0u$x`@j{5+n6ZdGsqf?wRRkX=>58$bSx5WUij{G<kN1E{H6sKIB09PmA
zc?NHX0?a$=#hEyP1gFt6ia->BnGr}}S1q}iWQajh{{4G)f(eToPR^9bT77+K!%8DZ
zT)$xQ&{MC!v9_F)`Zc5`#_4H+=S^;-PHPw*i=HKrz5F!6;}iHK%=cq?Z`0^U?|jCv
z1Z-rjX(W|o0yy|2RK;+(Aq-;mU5KH?^ZVcbZ~MpBonrod{Au6i_yNCC98ELZyNOQR
zz}Op3tnu^we)m4)`28|n|Cr111AaH(NBz>6F<p#%D&U(mJ{{)!{r~m9>8j)}N^vjQ
z@MEYX6TrbIeVUKl#yDnVI*6oY9U=)y__2(Ab^OD`FH8C8v*SloSt^JpfzF78cx;SG
zmfdN5+Cfa`yj5Pxk89ZnrQ9fE&yVf&l4bD8h|j@DO;BX`v`B%yIYE@|w;;-jvVN?m
z?B^c*;!PIA)5uTf_1BRP;%1Xe9pWw^TAS=4E{m{6LYQgzNm)5R-Ur_P-MZC0|0>8%
zWBq@!L7dEg4bF}>&W<idHHfdec`-@^_<mf^9WMRmA(?4Bm1F`q>KKkHoDnU=62fr*
zYsf9}{Qf(;b{=W_)SHhyU4N#P;|KiKFu%3L#O!j&IF8>SM!Mikc(eb}^n{^1Zd==X
zAk3<&uBjDk#d`6&<hWHxx+yp3^rY+^v^8j1M!NW(N^jG(!kE(3Yng6JH#M6n=&FVy
z*ADBZY885{oT)lYH^~{IBuZmSY~Q|)?ylB&XLt8xYkXgKM_X%rMQ7LKq$JL3S$^r(
zu{}oCwCD_t7kG<Bau#owo_FJ0XjH*k`TRf`2`Asn$31Ihaoisk$1T;>%V)`hL)(T&
z<T0f&j|1$VaCOUcwrRG5bWCY*Fc2FumN{T+ls}xYj9k`q#*{gkl#$69DOX!-7)kvm
z4f`6LjBOdlfaU1a%=Qsi+v`%^4A#h~W7%#mGd7~5eJ-Ws9Br$HM)kbbho+sT((w5U
zNQY+6Z(e-CvgIqfFYmc><JHF-lsS!an`C(uBW}9-k95r*D(I>^zCGn+G*i{h-NSj^
z(bI-DXr{8-9B7rK<BiIkhS-AGxuVh{j^xt%4LRMtk=a_fC?;R4qVFx1O0B8N5m92C
zC5vLQ9hB2+Yxq<}k#%3VG$s!^I7lVs3I4EEmIwD>N+=Gxq5#|4<=BvsN^6FqN?dJa
zmmC|;^EfM;yw254a%==w7FisM<Mpk%A{N_8-EK}fZvTX4BBVDx-@V8ib;eV+)?dJs
z^m^B0FZ=1RpDL|Wb=RUyHtI#OEuy%c8eFTYn#%C?4^Rz7H}g7{0RD8m5|rPIqSR9S
z30e}%_-o5+*FVnQSU_76Yym_+IU-p|I!GVcOm^Yqvya?M9w1MUpOM$eG4d|?6FEsf
zC;tI}8jzq4>Y)kd!F-6pVps;Npc_`hrO*cha1CsQ9k2`1kO394V1o-e$iuDh6Sy7j
zfIH!ScnBVWN8vGe23~^0@Kg9XyajK=Z{ZzyA3laZ!(ZU<a7rKo2z5feAPZ*;=LsFc
z3Sp(tC9Dz>!UkchFf8oiBNB>5H_F?^r;x(8aM3w=Zz>TERVb<TS8dq1>HAYsCuZ{^
zns@g6IIXNpE?-+pLY}q7MD?dX%lSa1u$*T(5z5!&u?6Rx+q_UduULuU3LU~?(e{e8
zHkDc~y+l4=#9~pZd2^}!0};zaso~Am=8HuvOhsT#xxKkl!tzsQ@n&oDDoIp;H&)A+
zNmz(V6>lz-6OyD5)@bf+UMFHPDc@R_pCBKTzmb2CFEPt!!(7bmrO*bKz#6y;u7-Zh
z>m&@pP8fp}W;e}k6DHsWaNuT`#QdIu+u&}v2lm4OIEXp^FlIT;@n_+AcmZC7m*EvS
z3a`Si;MZ^r-hkg=*8c(i2%o^G@Xt^#Zz*Omr|_?tx$OV&rVC$8c^iRH#`{0Nm8Ak7
zVVI&$Lw52>+cYe5H*#pb)#B%wE>d({{<)zA0_k2pQ^JpSedF~9@8rw9kR3nT%2ENe
zWB{GvlE}pcla0%GEx3(YdFzvh!+bxMntP5s;zcfC!;hqrj2}nWO$mylnlIXB#$@9&
zL9QRe$<K~;cJO7BPv4KAyoBFB!5`vGzh-fOaeDrbyQ)h6|DWl@i10-bh$8R}A^=r=
z$-W*mP+Yl%ZPBy#INrPPrWci);*_c2gB`~sWykT@pvUnS;Z0?|H7$EjczsixGIf+;
m>PY!%{&)Uoz-i73f|EE!8Qk9o_KDH{KidEEbC2)c{{MeOUY_Ov

literal 0
HcmV?d00001

diff --git a/.claude/.DS_Store b/.claude/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..3a51aa2daa11f40aeb81b4a26b288a55ae0102cd
GIT binary patch
literal 6148
zcmeHKO-e&C5T4O4o^;ct%WT}Z>kZQKJVDoj)QW;FuUJdB0ng((yo?KPpx^u`eHg)o
zh{#OIe3Q&flJ`NA3=#2kyBHIVh^RpmWHBlt!&TRT2M>U(bKKJ%UE#M`URNgii$k*a
zBid1io!`>l{>QV+Znf4eH>W4{s8!dt^JO=Ow|RctJe<EiO}>g;d^2)=v$yi_MK=&C
z7zhS}fnXpQ_(2A6XNxpL!_dJ%Fc1uUFd*kcLKDo6#ZZq9C@lei@{Cr2EwzN?B**Mn
z4B>&Wr2;LLy~JQk$9VF%>{tvfo!E;H_Lbj@7uMA=f6{Q`Y#2Hi2nPBL99nlI_x~CG
zGSwo#pAx-bAQ<>(4Dg_xwNreQ->siMPwv`;c7Y}$aYYOW?A{{)9XUsi)oK1DHsZ2l
VF_c+kT+@N^5Kuxw1p~jpz#CD`G>HHJ

literal 0
HcmV?d00001

diff --git a/.claude/settings.local.json b/.claude/settings.local.json
new file mode 100644
index 0000000..ca90aa8
--- /dev/null
+++ b/.claude/settings.local.json
@@ -0,0 +1,27 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(doob:*)",
+      "Bash(echo:*)",
+      "Bash(gh:*)",
+      "Bash(op:*)",
+      "Bash(obfsck:*)",
+      "Bash(head:*)",
+      "Bash(git ls-files:*)",
+      "WebSearch",
+      "WebFetch(domain:www.apache.org)",
+      "Skill(todo:*)",
+      "Bash(PATH=\"/Users/joe/.local/share/mise/shims:$PATH\" which nu)",
+      "Bash(PATH=\"/Users/joe/.local/share/mise/shims:$PATH\" nu --version 2>&1 | head -1)",
+      "Bash(doob todo:*)",
+      "Bash(handoff-detect 2>&1; echo \"exit: $?\")",
+      "Bash(handoff-detect --name && handoff-detect --project)",
+      "Bash(rtk gain:*)",
+      "Bash(rtk rewrite:*)",
+      "Bash(rtk grep:*)",
+      "Bash(nu -c '\nlet result = \\(do { python3 -c \"import json; print\\(json.dumps\\({\\\\\"ok\\\\\": True}\\)\\)\" } | complete\\)\nprint $result.stdout\n')",
+      "Bash(echo '{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":\"grep -n \\\\\"^foo\\\\\" /file.md\"}}' | nu /Users/joe/.claude/hooks/nu/pre/grep-to-grep-tool.nu)",
+      "Bash(echo '{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":\"grep -c pattern file.txt\"}}' | nu /Users/joe/.claude/hooks/nu/pre/grep-to-grep-tool.nu\necho '{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":\"grep -i \\\\\"Hello World\\\\\" /dir/\"}}' | nu /Users/joe/.claude/hooks/nu/pre/grep-to-grep-tool.nu\necho '{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":\"git status\"}}' | nu /Users/joe/.claude/hooks/nu/pre/grep-to-grep-tool.nu; echo \"exit: $?\")"
+    ]
+  }
+}
diff --git a/.codex/hooks.json b/.codex/hooks.json
new file mode 100644
index 0000000..e6284b9
--- /dev/null
+++ b/.codex/hooks.json
@@ -0,0 +1,25 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'if [ -f Cargo.toml ]; then cargo check --quiet 2>&1 | head -20; fi'"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "nu /Users/joe/dev/notfiles/scripts/preflight.nu"
+          }
+        ]
+      }
+    ]
+  }
+}
diff --git a/.ctx/HANDOFF.md b/.ctx/HANDOFF.md
index 4adaeb6..54c4cd9 100644
--- a/.ctx/HANDOFF.md
+++ b/.ctx/HANDOFF.md
@@ -1,4 +1,4 @@
-# Handoff — notfiles (2026-06-06)
+# Handoff — notfiles (2026-07-07)
 
 **Branch:** main | **Build:** unknown | **Tests:** unknown
 
@@ -6,9 +6,11 @@
 
 | ID | P | Status | Title |
 |---|---|---|---|
+| uncommitted-work | P1 | open | Uncommitted changes (3 files) |
 
 ## Log
 
+- 20260606.135918: done=13 running=0 pending=0 blocked=0
 - 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
diff --git a/.ctx/HANDOFF.notfiles.notfiles.yaml b/.ctx/HANDOFF.notfiles.notfiles.yaml
index 4948220..0b9d98b 100644
--- a/.ctx/HANDOFF.notfiles.notfiles.yaml
+++ b/.ctx/HANDOFF.notfiles.notfiles.yaml
@@ -1,8 +1,28 @@
 project: notfiles
 id: notfile
-updated: 2026-06-06
-items: []
+updated: 2026-07-07
+items:
+- id: uncommitted-work
+  doob_uuid: null
+  name: uncommitted-work
+  priority: P1
+  status: open
+  title: Uncommitted changes (3 files)
+  description: |-
+    Working tree has uncommitted changes:
+    .claude/worktrees/agent-a27fe5f2
+    .claude/settings.local.json
+    .superpowers/brainstorm/72758-1776397235/state/server-stopped
+  files:
+  - .claude/worktrees/agent-a27fe5f2
+  - .claude/settings.local.json
+  - .superpowers/brainstorm/72758-1776397235/state/server-stopped
+  completed: null
+  extra: []
 log:
+- date: '20260606.135918'
+  summary: done=13 running=0 pending=0 blocked=0
+  commits: []
 - date: 2026-04-17
   summary: Added notnet crate with YubikeySource and threaded Tailscale into notstrap; design spec complete
   commits: []
@@ -12,8 +32,3 @@ log:
 - date: 2026-04-15
   summary: Pruned completed items from handoff; GitHub issues plus doob are now the source of truth for active work
   commits: []
-branch: main
-state:
-  tests: passing
-  build: clean
-  notes: Handoff is now ephemeral; track active work via GitHub issues synced through doob.
diff --git a/.notfiles-state.toml b/.notfiles-state.toml
new file mode 100644
index 0000000..7b71b67
--- /dev/null
+++ b/.notfiles-state.toml
@@ -0,0 +1,76 @@
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/aliases.nu"
+target = "/Users/joe/.config/nushell/autoload/aliases.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728685+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/audit.nu"
+target = "/Users/joe/.config/nushell/autoload/audit.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728734+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/did-you-mean.nu"
+target = "/Users/joe/.config/nushell/autoload/did-you-mean.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728773+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/functions.nu"
+target = "/Users/joe/.config/nushell/autoload/functions.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728809+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/nu_libs.nu"
+target = "/Users/joe/.config/nushell/autoload/nu_libs.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728847+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/nuenv.nu"
+target = "/Users/joe/.config/nushell/autoload/nuenv.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728879+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/session-guard.nu"
+target = "/Users/joe/.config/nushell/autoload/session-guard.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728915+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/settings.nu"
+target = "/Users/joe/.config/nushell/autoload/settings.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728947+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/autoload/toolkit-hook.nu"
+target = "/Users/joe/.config/nushell/autoload/toolkit-hook.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.728981+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/config.nu"
+target = "/Users/joe/.config/nushell/config.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.729023+00:00"
+
+[[entries]]
+package = "nushell"
+source = "/Users/joe/dev/notfiles/nushell/.config/nushell/env.nu"
+target = "/Users/joe/.config/nushell/env.nu"
+method = "symlink"
+linked_at = "2026-06-14T04:23:50.729055+00:00"
diff --git a/.sccignore b/.sccignore
new file mode 100644
index 0000000..43f2eb5
--- /dev/null
+++ b/.sccignore
@@ -0,0 +1,11 @@
+.ctx
+.kgx
+.github
+.claude
+docs
+examples
+fuzz
+target
+*.md
+*.json
+tests/
diff --git a/.superpowers/brainstorm/72758-1776397235/.DS_Store b/.superpowers/brainstorm/72758-1776397235/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..9ad8929eae4d39b9e9bf01228b1a944d259b6f6c
GIT binary patch
literal 8196
zcmeHMYitx%6u#fI&>1_xv=%7HrdyX+aIxD`k%Hi|EiY*W*_LigvF>ANN2W7%XLidY
zH6;e$iN;srFMR)O)M&&Q6#Zr5E1HHx5{Xe0@sGdwg9+%lb7u){ZK8=WpmURZ&pr1%
zX3p8~+}k^4j3H6TH8NJq7?Y`Us#VhPCymQ_pVlOQrJN|po-v(S%*~8A!x?j$cCZj+
zAjm+Ffgl4x27(M+3mKp@n>Treb6-e<F~~rWf&XO&`2G;4&S~7IV}g2H2Myj8fGEEL
zc#Y<C5AbZlK8^cyOi<61e2Uuxd{g*W3<z_Qhq*e@xKGCf73K`WoWXxG{2L0qr;}aS
zQ)h?^8jL{(f(%U0056{kmSr}-xnF&Mw=*O;nHe?>$Bo6#Kq@PrHM>HtkSpc=$w7N0
z>89O+lSt?Hajw(0%}i;Y&g?bxk$$bF)wbNUVd;6#z{u&O(${TRIeR2w7p$D)*(QZR
zR%E4Lt37(Osby_6yr!jPG#WnI(iDq^o7b!z9aZG{k%kR>`VX2zmi@R01pa2g=1d9f
ziRn?9PO&v(@~Fy^rKrx9qEc?CROhJOsh(c7FJ)wHD`_0j`?Yxvg|>s(-Fdx8A$4bM
zvoK^i{aRHvZDtE*+SNCkCRe7lc}_NOo91rYF<is8dQz@_$SpaVBue!<cHV9Eob_v3
z!O{2V<jW}PZRC+$Rr9Cq8s=`Cy?Wju8i~h5kjnVng>_3;u5P;hj`)@x9rsMk)2gb~
z8g)T;(Qu56sdtSSId`xp?PPT;XIKNhlwZp=4j6h~sX|ogw9-TRM0M?=#WyVpg{Eqk
zyrc>l<AH+V9@ZkVES^yxiYVH<a$k;Kvct}Ck2y~gst>J@<$Zj;HLuesmep0EsG_Ci
zPKOdCTr{YSismSt2MGkiv{_v%YdNLMOlNdcEVZZ`WNoL?T@;av#TxZaSxIH>p&<&!
z5o?K1o2-2*-^(A|o_5?_!@5;^r9^1EEcZHt>Ab#cgdkY5XqRR0hoyCHvL$D@cHYaz
z-SweR4|laWm(z0;^y1n@)uCjlOV++28_lqa27#V_3xRzlQbJuMzDi6Zrw3m0W?qh!
znv#M~`5_l#%h@^>XPxW-72PrRBs;<0VW-%K><e~=ont?-U)e?W8@t3VqYNslu>?!8
z8V!h{5$mx58?gyH(TOhXMFt09!h#JKqj(TwIEIJu6rRR2cor|>6}*bq@dn269!}zY
ze1gyLIljbKIESBc9>3rMF5xnMm#U=2(o$)ev|MVCVp5Z|M%pTElXgozQbrn(21Nu?
zso?fcj!ZgC{FH5k3XVPl@`97bXDGOB+jrchwqNrF_w8I>VmH>zU$8K|Y*j<^x{aH!
z08!w!1l6lcz(f6{TJcctA!90HMJ=jzT~rqOp_xijtKj7;PjKz}o7FmP78Q<Qm#-jp
zHWiIvZ;95`X%f|{U}KGSs#ZposCc%wMTv#aw5(TEt(<C7$To$DWj>Q=B{#gn<bN9L
zU$e99dv=~(U>7kPmC#U!mADnngzc@^PWWy|2jM$~UhG33bPT}2{e*TGMI6Fm9Kl04
zjz{n)9wV$jhv)GEPT*z2`)h>walDDQ@HRfcDSU*}_}D}K1ir%$_;CuBJ0@cp7p7ym
zn9N(IZ4Hp5Q~{HXu1l^=ymc+V|8JT3`~P(rTkz6B27(OywG5!VE!mbJ-I?|_iDY5w
z_fhAK>x~KOnb5#h__}u;Cwk={hBOcRvbayj1SJWzfBi$i-~WR<IRAt5|37#B{{e`S
Bch~>`

literal 0
HcmV?d00001

diff --git a/.superpowers/brainstorm/72758-1776397235/state/server-stopped b/.superpowers/brainstorm/72758-1776397235/state/server-stopped
new file mode 100644
index 0000000..ac70b7f
--- /dev/null
+++ b/.superpowers/brainstorm/72758-1776397235/state/server-stopped
@@ -0,0 +1 @@
+{"reason":"idle timeout","timestamp":1776399095365}
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..d97f87a
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,110 @@
+# AGENTS.md
+
+This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.
+
+## What is notfiles?
+
+A modern dotfiles manager written in Rust — a pure Rust alternative to GNU Stow. It symlinks (or copies) files from organized "package" directories into a target location (typically `~`).
+
+## Build & Test Commands
+
+```bash
+cargo build                        # build all workspace crates
+cargo build -p notfiles            # build just the notfiles binary
+cargo test                         # run all tests across workspace
+cargo test -p notcore              # test notcore only
+cargo test -p notfiles             # test notfiles only
+cargo test -p notsecrets           # test notsecrets only
+cargo test -p nothooks             # test nothooks only
+cargo clippy --workspace           # lint all crates
+cargo fmt --check                  # check formatting
+```
+
+## Workspace Structure
+
+This is a Cargo workspace with 7 crates under `crates/`:
+
+| Crate        | Purpose                                                                    |
+| ------------ | -------------------------------------------------------------------------- |
+| `notcore`    | Shared types: `Config`, `NotfilesError`, `Reporter`, `LinkEvent`,          |
+|              | `expand_tilde`, `suggest_package`, `HookPhase`, `HookSpec`, `Report`       |
+| `notfiles`   | Dotfiles linker — lib + `notfiles` binary. Subcommands: `init`, `link`,    |
+|              | `unlink`, `status`, `check`, `diff`, `adopt`, `completions`               |
+| `notsecrets` | Multi-provider secret resolution (`SecretResolver`), age encryption/       |
+|              | decryption, identity management                                           |
+| `nothooks`   | Nushell hook runner with dot/setup phases and state persistence            |
+| `notnet`     | Network utilities — Tailscale integration, YubikeySource                   |
+| `notstrap`   | New-machine bootstrap orchestrator — ties all crates together              |
+| `notgraph`   | Dependency/import graph for Rust files — HTML/MD/JSON/Mermaid output,      |
+|              | heatmap, cycle detection                                                   |
+
+## Architecture
+
+### notfiles (primary user-facing tool)
+
+Eight subcommands: `init`, `link`, `unlink`, `status`, `check`, `diff`,
+`adopt`, `completions`. Global flags: `--dry-run`, `--verbose`, `--json`.
+CLI parsing in `crates/notfiles/src/cli.rs`; dispatch in `src/main.rs`.
+
+**Core flow for `link`:** `main` → `config.validate()` →
+`resolve_packages_filtered` (include/exclude + platform filtering) →
+`collect_files` (recursive walk with ignore filtering) →
+`linker::link_package` (create symlinks or copies, record in state,
+return `LinkResult` with counters).
+
+**Architecture**: Hexagonal (ports/adapters). `FileStore` trait abstracts
+filesystem I/O; `Reporter` trait abstracts output. Adapters:
+`FileStoreImpl` (real fs), `InMemoryFileStore` (testing),
+`TerminalReporter` (ANSI), `JsonReporter` (NDJSON).
+
+Key modules in `crates/notfiles/src/`:
+
+- **linker** — Creates/removes symlinks or copies via `FileStore` port.
+  Manages `State` (`.notfiles-state.toml`). Returns `LinkResult` with
+  linked/copied/skipped/backed_up counts. Also provides `adopt_files`.
+- **package** — Discovers packages with include/exclude and platform
+  filtering. Recursively collects files via `IgnoreMatcher`. Typo
+  suggestions via `suggest_package` on not-found errors.
+- **ignore** — Glob-based ignore matching using `globset`.
+- **status** — Compares expected vs actual state:
+  linked/copied/missing/conflict/orphan. Also provides `diff_package`
+  for copy-method divergence detection.
+- **adapters/** — `FileStoreImpl`, `InMemoryFileStore`,
+  `TerminalReporter`, `JsonReporter`.
+- **ports** — `FileStore` trait definition.
+
+### notsecrets
+
+Multi-provider secret resolution via `SecretResolver`. Providers include
+`EnvSource`, `OpSource` (1Password), `BitwardenSource`, `FileSource`,
+`DotenvxSource`, `SopsSource`, and others. Native age encryption/decryption
+with x25519, SSH ed25519/RSA, and scrypt identity support. No external
+`sops` or `age` binaries required.
+
+### nothooks
+
+`HookRunner` executes `.nu` scripts via `nu <script>`. Two phases: `HookPhase::Dot` (always runs) and `HookPhase::Setup` (runs once, tracked in `.nothooks-state.toml`). `--force` flag reruns setup hooks.
+
+### notstrap
+
+Orchestrates in order: prereqs check → load config → clone dotfiles → age key → decrypt SOPS → link dotfiles → run hooks → final report. Config file: `notstrap.toml`.
+
+## Configuration
+
+`notfiles.toml` lives at the dotfiles directory root. Each subdirectory
+is a "package".
+
+Global defaults support `include` (allowlist) or `exclude` (blocklist)
+for package filtering — mutually exclusive. Per-package config can
+override: `method` (symlink/copy), `target` directory, additional
+`ignore` patterns, and `platforms` (e.g. `["linux"]`, `["macos"]`) to
+gate packages to specific OSes.
+
+## Edition
+
+Rust edition 2024. All hook scripts are Nushell (`.nu`) — no `.sh` scripts.
+
+## CI / Gitea Actions
+
+Workflows live in `.gitea/workflows/` — mirrors `.github/workflows/` for GitHub.
+The `public-ready.yml` workflow checks secrets, private IPs, licenses, and tracked secrets files on every push to main.
diff --git a/CLAUDE.md b/CLAUDE.md
index 4075d4e..2b6e0fc 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -22,36 +22,64 @@ cargo fmt --check                  # check formatting
 
 ## Workspace Structure
 
-This is a Cargo workspace with 5 crates under `crates/`:
+This is a Cargo workspace with 7 crates under `crates/`:
 
-| Crate        | Purpose                                                                                                  |
-| ------------ | -------------------------------------------------------------------------------------------------------- |
-| `notcore`    | Shared types: `Config`, `NotfilesError`, `expand_tilde`, `HookPhase`, `HookSpec`, `Report`, `StepStatus` |
-| `notfiles`   | Dotfiles linker — lib + `notfiles` binary (symlink/copy, init, status)                                   |
-| `notsecrets` | Age key retrieval via Bitwarden, file, or prompt; SOPS decryption                                        |
-| `nothooks`   | Nushell hook runner with dot/setup phases and state persistence                                          |
-| `notstrap`   | New-machine bootstrap orchestrator — ties all crates together                                            |
-| `notgraph`   | Dependency/import graph for Rust files — HTML/MD/JSON/Mermaid output, heatmap, cycle detection           |
+| Crate        | Purpose                                                                    |
+| ------------ | -------------------------------------------------------------------------- |
+| `notcore`    | Shared types: `Config`, `NotfilesError`, `Reporter`, `LinkEvent`,          |
+|              | `expand_tilde`, `suggest_package`, `HookPhase`, `HookSpec`, `Report`       |
+| `notfiles`   | Dotfiles linker — lib + `notfiles` binary. Subcommands: `init`, `link`,    |
+|              | `unlink`, `status`, `check`, `diff`, `adopt`, `completions`               |
+| `notsecrets` | Multi-provider secret resolution (`SecretResolver`), age encryption/       |
+|              | decryption, identity management                                           |
+| `nothooks`   | Nushell hook runner with dot/setup phases and state persistence            |
+| `notnet`     | Network utilities — Tailscale integration, YubikeySource                   |
+| `notstrap`   | New-machine bootstrap orchestrator — ties all crates together              |
+| `notgraph`   | Dependency/import graph for Rust files — HTML/MD/JSON/Mermaid output,      |
+|              | heatmap, cycle detection                                                   |
 
 ## Architecture
 
 ### notfiles (primary user-facing tool)
 
-Four subcommands: `init`, `link`, `unlink`, `status`. CLI parsing in `crates/notfiles/src/cli.rs`; dispatch in `src/main.rs`.
+Eight subcommands: `init`, `link`, `unlink`, `status`, `check`, `diff`,
+`adopt`, `completions`. Global flags: `--dry-run`, `--verbose`, `--json`.
+CLI parsing in `crates/notfiles/src/cli.rs`; dispatch in `src/main.rs`.
 
-**Core flow for `link`:** `main` → `resolve_packages` → `collect_files` (recursive walk with ignore filtering) → `linker::link_package` (create symlinks or copies, record in state).
+**Core flow for `link`:** `main` → `config.validate()` →
+`resolve_packages_filtered` (include/exclude + platform filtering) →
+`collect_files` (recursive walk with ignore filtering) →
+`linker::link_package` (create symlinks or copies, record in state,
+return `LinkResult` with counters).
+
+**Architecture**: Hexagonal (ports/adapters). `FileStore` trait abstracts
+filesystem I/O; `Reporter` trait abstracts output. Adapters:
+`FileStoreImpl` (real fs), `InMemoryFileStore` (testing),
+`TerminalReporter` (ANSI), `JsonReporter` (NDJSON).
 
 Key modules in `crates/notfiles/src/`:
 
-- **linker** — Creates/removes symlinks or copies. Manages `State` (`.notfiles-state.toml`) tracking every linked file. Handles conflict detection, `--force` backups, empty-parent cleanup on unlink.
-- **config** — Parses `notfiles.toml`. Per-package overrides for method, target, ignore. Falls back to `[defaults]`.
-- **package** — Discovers packages (non-hidden subdirs) and recursively collects files via `IgnoreMatcher`.
+- **linker** — Creates/removes symlinks or copies via `FileStore` port.
+  Manages `State` (`.notfiles-state.toml`). Returns `LinkResult` with
+  linked/copied/skipped/backed_up counts. Also provides `adopt_files`.
+- **package** — Discovers packages with include/exclude and platform
+  filtering. Recursively collects files via `IgnoreMatcher`. Typo
+  suggestions via `suggest_package` on not-found errors.
 - **ignore** — Glob-based ignore matching using `globset`.
-- **status** — Compares expected vs actual state: linked/copied/missing/conflict/orphan.
+- **status** — Compares expected vs actual state:
+  linked/copied/missing/conflict/orphan. Also provides `diff_package`
+  for copy-method divergence detection.
+- **adapters/** — `FileStoreImpl`, `InMemoryFileStore`,
+  `TerminalReporter`, `JsonReporter`.
+- **ports** — `FileStore` trait definition.
 
 ### notsecrets
 
-`AgeKeySource` trait with three implementations: `BitwardenSource` (bw CLI), `FileSource`, `PromptSource`. `resolve_age_key()` tries each in order. `install_age_key()` writes to `~/.config/sops/age/keys.txt` (mode 0600). `decrypt_sops()` shells out to `sops --decrypt`.
+Multi-provider secret resolution via `SecretResolver`. Providers include
+`EnvSource`, `OpSource` (1Password), `BitwardenSource`, `FileSource`,
+`DotenvxSource`, `SopsSource`, and others. Native age encryption/decryption
+with x25519, SSH ed25519/RSA, and scrypt identity support. No external
+`sops` or `age` binaries required.
 
 ### nothooks
 
@@ -63,7 +91,14 @@ Orchestrates in order: prereqs check → load config → clone dotfiles → age
 
 ## Configuration
 
-`notfiles.toml` lives at the dotfiles directory root. Each subdirectory is a "package". Per-package config can override: `method` (symlink/copy), `target` directory, additional `ignore` patterns.
+`notfiles.toml` lives at the dotfiles directory root. Each subdirectory
+is a "package".
+
+Global defaults support `include` (allowlist) or `exclude` (blocklist)
+for package filtering — mutually exclusive. Per-package config can
+override: `method` (symlink/copy), `target` directory, additional
+`ignore` patterns, and `platforms` (e.g. `["linux"]`, `["macos"]`) to
+gate packages to specific OSes.
 
 ## Edition
 
diff --git a/Cargo.lock b/Cargo.lock
index 4d94c6f..66bd114 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -278,6 +278,15 @@ dependencies = [
  "strsim",
 ]
 
+[[package]]
+name = "clap_complete"
+version = "4.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e0a7a9bfdb35811f9e59832f0f05975114d2251b415fb534108e6f34060fd772"
+dependencies = [
+ "clap",
+]
+
 [[package]]
 name = "clap_derive"
 version = "4.6.0"
@@ -892,6 +901,7 @@ dependencies = [
  "anyhow",
  "dirs",
  "serde",
+ "strsim",
  "thiserror 2.0.18",
  "toml",
 ]
@@ -904,10 +914,12 @@ dependencies = [
  "assert_fs",
  "chrono",
  "clap",
+ "clap_complete",
  "dirs",
  "globset",
  "notcore",
  "serde",
+ "serde_json",
  "tempfile",
  "toml",
 ]
@@ -965,7 +977,6 @@ dependencies = [
  "notcore",
  "rand",
  "rpassword",
- "rsa",
  "scrypt",
  "serde",
  "sha2",
@@ -1256,9 +1267,9 @@ checksum = "f8dcc9c7d52a811697d2151c701e0d08956f92b0e24136cf4cf27b57a6a0d9bf"
 
 [[package]]
 name = "rand"
-version = "0.8.5"
+version = "0.8.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
+checksum = "5ca0ecfa931c29007047d1bc58e623ab12e5590e8c7cc53200d5202b69266d8a"
 dependencies = [
  "libc",
  "rand_chacha",
diff --git a/Cargo.toml b/Cargo.toml
index 4afe364..ef8db75 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,5 +1,10 @@
 [workspace.package]
 license = "MIT OR Apache-2.0"
+repository = "https://github.com/89jobrien/notfiles"
+homepage = "https://github.com/89jobrien/notfiles"
+keywords = ["dotfiles", "symlink", "stow", "config"]
+categories = ["command-line-utilities", "filesystem"]
+readme = "README.md"
 
 [workspace]
 members = [
@@ -17,10 +22,13 @@ resolver = "2"
 [workspace.dependencies]
 anyhow      = "1"
 clap        = { version = "4", features = ["derive"] }
+clap_complete = "4"
 chrono      = { version = "0.4", default-features = false, features = ["clock"] }
 dirs        = "6"
 globset     = "0.4"
 serde       = { version = "1", features = ["derive"] }
+serde_json  = "1"
+strsim      = "0.11"
 thiserror   = "2"
 toml        = "0.8"
 which       = "7"
diff --git a/README.md b/README.md
index 5411695..1708ac4 100644
--- a/README.md
+++ b/README.md
@@ -15,10 +15,24 @@ notfiles link
 # Check status
 notfiles status
 
+# Validate config without changes (CI-friendly)
+notfiles check
+
+# Show copy-method divergence
+notfiles diff
+
+# Move an existing file into a package
+notfiles adopt git .gitconfig
+
 # Remove symlinks
 notfiles unlink
+
+# Generate shell completions
+notfiles completions bash > ~/.bash_completion.d/notfiles
 ```
 
+All commands support `--dry-run`, `--verbose`, and `--json` flags.
+
 On a new machine (once `notstrap` ships):
 
 ```bash
@@ -33,11 +47,13 @@ notstrap run
 ```
 notfiles/
 ├── crates/
-│   ├── notcore/        # shared types, config, paths, errors
+│   ├── notcore/        # shared types, config, paths, errors, Reporter trait
 │   ├── notfiles/       # symlink engine (stow replacement)  ← you are here
-│   ├── notsecrets/     # age key retrieval + sops decrypt
+│   ├── notsecrets/     # multi-provider secret resolution + age crypto
 │   ├── nothooks/       # hook execution engine
-│   └── notstrap/       # new-machine bootstrap orchestrator
+│   ├── notnet/         # network utilities (Tailscale, Yubikey)
+│   ├── notstrap/       # new-machine bootstrap orchestrator
+│   └── notgraph/       # Rust dependency graph visualizer
 ├── notfiles.toml       # symlink package config
 └── notstrap.toml       # bootstrap hook/phase config
 ```
@@ -46,11 +62,13 @@ notfiles/
 
 | Crate | Type | Does |
 |-------|------|------|
-| `notcore` | lib | Shared types, config, paths, errors — no deps on other crates |
-| `notfiles` | lib + bin | Symlink/copy packages into `$HOME`, track state |
-| `notsecrets` | lib | Retrieve age key → sops decrypt → inject secrets |
+| `notcore` | lib | Shared types, config, paths, errors, Reporter trait — no deps on other crates |
+| `notfiles` | lib + bin | Symlink/copy packages into `$HOME`, track state, adopt/diff/check |
+| `notsecrets` | lib | Multi-provider secret resolution, native age encryption/decryption |
 | `nothooks` | lib + bin | Run bootstrap hooks in phases, skip already-run setup hooks |
+| `notnet` | lib | Tailscale integration, Yubikey identity source |
 | `notstrap` | bin | Orchestrate everything on a fresh machine |
+| `notgraph` | lib + bin | Rust file dependency/import graph with HTML/Mermaid output |
 
 ### Dependency graph
 
@@ -60,6 +78,7 @@ notstrap
   │     └── notcore
   ├── notsecrets
   │     └── notcore
+  ├── notnet
   └── nothooks
         └── notcore
 ```
@@ -91,13 +110,16 @@ State is tracked in `.notfiles-state.toml` so `unlink` and `status` know exactly
 ```
 notfiles link
   │
-  ├─ resolve_packages()     discover subdirs or validate requested names
+  ├─ config.validate()                check include/exclude mutual exclusion
   │
-  ├─ collect_files()        recursive walk, apply ignore patterns (globset)
+  ├─ resolve_packages_filtered()      include/exclude + platform filtering
   │
-  ├─ conflict_check()       existing file? symlink to wrong target?
+  ├─ collect_files()                  recursive walk, apply ignore patterns
   │
-  └─ linker::link_package() create symlinks (or copies), write state
+  ├─ conflict_check()                 existing file? symlink to wrong target?
+  │
+  └─ linker::link_package()           create symlinks (or copies), write state,
+                                      return LinkResult with counters
 ```
 
 ### State file
@@ -156,16 +178,21 @@ Note: 1Password (`op`) is installed as a **hook** in phase `setup` — after sec
 
 ## Secrets Bootstrap Detail
 
-`notsecrets` implements an `AgeKeySource` trait with three sources tried in order:
+`notsecrets` implements a `SecretResolver` with pluggable provider sources:
 
 ```
-AgeKeySource
-  ├── BitwardenSource   bw unlock → session token → bw get item age-key
-  ├── FileSource        read from --key-file path (USB, etc.)
-  └── PromptSource      read from stdin (paste)
+SecretResolver
+  ├── EnvSource         read from environment variables
+  ├── OpSource          1Password CLI (op read)
+  ├── BitwardenSource   bw CLI
+  ├── FileSource        read from file path
+  ├── DotenvxSource     dotenvx encrypted .env files
+  ├── SopsSource        SOPS-encrypted files (native age decryption)
+  └── ...               (extensible via SecretSource trait)
 ```
 
-Once the age key is retrieved, it's written to `~/.config/sops/age/keys.txt` and `sops` decrypts `secrets.sops.env`. The decrypted file contains all critical bootstrap credentials (op, bw, github, openai, anthropic, etc.) and is injected into the environment for subsequent hooks.
+Age encryption/decryption is handled natively (no external `age` or `sops`
+binaries). Supports x25519, SSH ed25519/RSA, and scrypt identities.
 
 ---
 
@@ -190,10 +217,15 @@ Once the age key is retrieved, it's written to `~/.config/sops/age/keys.txt` and
 [defaults]
 method = "symlink"
 target = "~"
+include = ["git", "zsh", "nushell", "starship"]  # allowlist (optional)
+# exclude = ["scratch"]                           # or blocklist (mutually exclusive)
 
 [packages.secrets]
 method = "copy"    # copy instead of symlink for sensitive files
 
+[packages.nixos]
+platforms = ["linux"]  # only link on Linux
+
 [packages.work]
 target = "~/work"  # different target dir
 ignore = ["*.local"]
diff --git a/crates/.DS_Store b/crates/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..87947181c370660a58968313608403697b01dc5e
GIT binary patch
literal 8196
zcmeHMF-#jV6#Xty8<hohV(4%aD`n^iI#4RQ(F%!)ff6VI5-uWizp6qEEFF+4b*hA5
zXKf|uMmw;vFrzLN3u0s9ef#HPCzq5isHoqP{gU(hzL#g~{@EcSGx2U=glLe6il~eO
z{b+Iu_jBzi59G>Ipg}xQLhH0xT^gA#Cmn3Ppbn@5>VP_+4yXhFf&<9eT#8-tzU$Ri
z9Z(1UO9%M*5TP>0f~iCM=s;t)0Kft++k(&72iTZMFcwT5+E9$?b`M5EjchTD3rBy%
zbYLu)I&|S=TsRrIvymN&v3EyYWa(sLhuW$G>OiLhymx;@YuLGOP}$$V*XoWu%5Mj4
zj9OAE%~z9o^b}_bXFJb-ACKp;7H+|+SNOD`dAE;z)1v5kOUqQHMQXSc1>u;_*LfUY
z)7Iw8Pok+~tXk4i)r%MC>U-wvTEZ#E8>&+!&_&0yp014J>)Jbd|Fi$Q^{T1M<F$14
z;sv@);8z9nm(XgPU-bIG)0J_2UB5nD)J_irT^_Hcs~0cOMPJyjhcb_An8S_Gt7y2r
z-`BJKYUu0L5345_!=JluoKVLc>v$|W8qiVZ6Dq9rwl%f8-i_z$I{9`!HtE)S?wG#5
zKXC({eJnFu_YLT?D=hSEawU)B>w7Y_e<{8-*H<={udNp^&_yZh;*=W;rVecuMq{%u
zQ1d^0(V`CACkNb9hXy&rzvzDcf1iGmYE=i+fxmRX6iU;j2?W`!o)gSjK0=*C<-)ww
kp$$P3ya?cX_J<)pN1$>{ESNgP6%;)Pur_F;4&12&H-b73ZU6uP

literal 0
HcmV?d00001

diff --git a/crates/notcore/Cargo.toml b/crates/notcore/Cargo.toml
index 4f1658a..9a18258 100644
--- a/crates/notcore/Cargo.toml
+++ b/crates/notcore/Cargo.toml
@@ -3,10 +3,16 @@ name    = "notcore"
 version = "0.1.0"
 edition = "2024"
 license.workspace = true
+repository.workspace = true
+homepage.workspace = true
+keywords.workspace = true
+categories.workspace = true
+description = "Shared types and config for the notfiles dotfiles manager"
 
 [dependencies]
 serde     = { workspace = true }
 toml      = { workspace = true }
 thiserror = { workspace = true }
 dirs      = { workspace = true }
+strsim    = { workspace = true }
 anyhow    = { workspace = true }
diff --git a/crates/notcore/src/config.rs b/crates/notcore/src/config.rs
index 9f2320a..101db30 100644
--- a/crates/notcore/src/config.rs
+++ b/crates/notcore/src/config.rs
@@ -18,6 +18,14 @@ pub struct Defaults {
     pub target: String,
     #[serde(default = "default_ignore")]
     pub ignore: Vec<String>,
+    /// If set, only these package names are discovered.
+    /// Mutually exclusive with `exclude`.
+    #[serde(default)]
+    pub include: Vec<String>,
+    /// If set, these package names are skipped during discovery.
+    /// Mutually exclusive with `include`.
+    #[serde(default)]
+    pub exclude: Vec<String>,
 }
 
 impl Default for Defaults {
@@ -25,6 +33,8 @@ impl Default for Defaults {
         Self {
             target: default_target(),
             ignore: default_ignore(),
+            include: Vec::new(),
+            exclude: Vec::new(),
         }
     }
 }
@@ -52,6 +62,10 @@ pub struct PackageConfig {
     pub target: Option<String>,
     #[serde(default)]
     pub ignore: Vec<String>,
+    /// If non-empty, this package is only linked on these platforms.
+    /// Valid values: "macos", "linux".
+    #[serde(default)]
+    pub platforms: Vec<String>,
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Default)]
@@ -100,6 +114,50 @@ impl Config {
             .unwrap_or(&self.defaults.target)
     }
 
+    /// Returns the include list if non-empty, or None (meaning all).
+    pub fn included_packages(&self) -> Option<Vec<&str>> {
+        if self.defaults.include.is_empty() {
+            None
+        } else {
+            let mut v: Vec<&str> = self.defaults.include.iter().map(|s| s.as_str()).collect();
+            v.sort();
+            Some(v)
+        }
+    }
+
+    /// Returns true if this package name appears in the exclude list.
+    pub fn is_package_excluded(&self, name: &str) -> bool {
+        self.defaults.exclude.iter().any(|e| e == name)
+    }
+
+    /// Validate config invariants. Returns Err if include and exclude
+    /// are both non-empty.
+    pub fn validate(&self) -> Result<(), NotfilesError> {
+        if !self.defaults.include.is_empty() && !self.defaults.exclude.is_empty() {
+            return Err(NotfilesError::Validation(
+                "include and exclude are mutually exclusive".into(),
+            ));
+        }
+        Ok(())
+    }
+
+    /// Returns true if the package should be linked on the current OS.
+    /// Empty platforms list means "all platforms".
+    pub fn is_package_for_current_platform(&self, package: &str) -> bool {
+        let platforms = match self.packages.get(package) {
+            Some(pkg) if !pkg.platforms.is_empty() => &pkg.platforms,
+            _ => return true,
+        };
+        let current = if cfg!(target_os = "macos") {
+            "macos"
+        } else if cfg!(target_os = "linux") {
+            "linux"
+        } else {
+            return false;
+        };
+        platforms.iter().any(|p| p == current)
+    }
+
     pub fn ignore_patterns_for(&self, package: &str) -> Vec<&str> {
         let mut patterns: Vec<&str> = self.defaults.ignore.iter().map(|s| s.as_str()).collect();
         if let Some(pkg) = self.packages.get(package) {
@@ -111,6 +169,23 @@ impl Config {
     }
 }
 
+/// Suggest the closest package name if the user made a typo.
+/// Returns None if no close match (distance > 2).
+pub fn suggest_package<'a>(name: &str, available: &[&'a str]) -> Option<&'a str> {
+    available
+        .iter()
+        .filter_map(|candidate| {
+            let dist = strsim::damerau_levenshtein(name, candidate);
+            if dist <= 2 {
+                Some((*candidate, dist))
+            } else {
+                None
+            }
+        })
+        .min_by_key(|(_, d)| *d)
+        .map(|(name, _)| name)
+}
+
 pub fn starter_toml() -> &'static str {
     r#"[defaults]
 target = "~"
@@ -138,6 +213,92 @@ mod tests {
         assert_eq!(config.target_for("anything"), "~");
     }
 
+    #[test]
+    fn test_include_filter_restricts_packages() {
+        let toml_str = r#"
+[defaults]
+target = "~"
+ignore = [".git"]
+include = ["git", "zsh", "nushell"]
+"#;
+        let config: Config = toml::from_str(toml_str).unwrap();
+        assert_eq!(
+            config.included_packages(),
+            Some(vec!["git", "nushell", "zsh"]),
+        );
+    }
+
+    #[test]
+    fn test_exclude_filter_blocks_packages() {
+        let toml_str = r#"
+[defaults]
+target = "~"
+ignore = [".git"]
+exclude = ["scripts", "docs", "tests"]
+"#;
+        let config: Config = toml::from_str(toml_str).unwrap();
+        assert!(config.is_package_excluded("scripts"));
+        assert!(!config.is_package_excluded("zsh"));
+    }
+
+    #[test]
+    fn test_include_and_exclude_mutual_exclusion() {
+        let toml_str = r#"
+[defaults]
+target = "~"
+include = ["git"]
+exclude = ["scripts"]
+"#;
+        let config: Config = toml::from_str(toml_str).unwrap();
+        assert!(config.validate().is_err());
+    }
+
+    #[test]
+    fn test_no_include_no_exclude_returns_none() {
+        let config = Config::default();
+        assert_eq!(config.included_packages(), None);
+        assert!(!config.is_package_excluded("anything"));
+        assert!(config.validate().is_ok());
+    }
+
+    #[test]
+    fn test_platform_filter_linux_only() {
+        let toml_str = r#"
+[defaults]
+target = "~"
+
+[packages.nixos]
+platforms = ["linux"]
+
+[packages.git]
+"#;
+        let config: Config = toml::from_str(toml_str).unwrap();
+        // On macOS this should be false, on Linux true
+        if cfg!(target_os = "macos") {
+            assert!(!config.is_package_for_current_platform("nixos"));
+        } else if cfg!(target_os = "linux") {
+            assert!(config.is_package_for_current_platform("nixos"));
+        }
+        // git has no platform filter — always matches
+        assert!(config.is_package_for_current_platform("git"));
+        // unknown package — no config entry, always matches
+        assert!(config.is_package_for_current_platform("zsh"));
+    }
+
+    #[test]
+    fn test_platform_filter_macos_only() {
+        let toml_str = r#"
+[packages.vscode]
+platforms = ["macos"]
+"#;
+        let config: Config = toml::from_str(toml_str).unwrap();
+        if cfg!(target_os = "macos") {
+            assert!(config.is_package_for_current_platform("vscode"));
+        } else {
+            assert!(!config.is_package_for_current_platform("vscode"));
+        }
+    }
+
     #[test]
     fn test_parse_config() {
         let toml_str = r#"
diff --git a/crates/notcore/src/error.rs b/crates/notcore/src/error.rs
index 38979e7..37e8626 100644
--- a/crates/notcore/src/error.rs
+++ b/crates/notcore/src/error.rs
@@ -17,6 +17,12 @@ pub enum NotfilesError {
     #[error("state file error: {0}")]
     State(String),
 
+    #[error("glob error: {0}")]
+    Glob(String),
+
+    #[error("validation error: {0}")]
+    Validation(String),
+
     #[error("{0}")]
     Io(#[from] std::io::Error),
 
diff --git a/crates/notcore/src/lib.rs b/crates/notcore/src/lib.rs
index 07416d0..eb88c91 100644
--- a/crates/notcore/src/lib.rs
+++ b/crates/notcore/src/lib.rs
@@ -1,9 +1,17 @@
+//! Core types and configuration for the notfiles dotfiles manager.
+//!
+//! This crate provides shared types used across the notfiles workspace:
+//! configuration parsing, error types, path utilities, and the reporter
+//! trait for output abstraction.
+
 pub mod config;
 pub mod error;
 pub mod paths;
+pub mod reporter;
 pub mod types;
 
-pub use config::{Config, Defaults, Method, PackageConfig};
+pub use config::{Config, Defaults, Method, PackageConfig, suggest_package};
 pub use error::NotfilesError;
 pub use paths::{dotfiles_dir, expand_tilde};
+pub use reporter::{LinkEvent, Reporter, SilentReporter};
 pub use types::{HookPhase, HookSpec, PackageSpec, Report, Step, StepStatus};
diff --git a/crates/notcore/src/reporter.rs b/crates/notcore/src/reporter.rs
new file mode 100644
index 0000000..81ffb7f
--- /dev/null
+++ b/crates/notcore/src/reporter.rs
@@ -0,0 +1,46 @@
+use std::path::Path;
+
+/// Events emitted during link/unlink/status operations.
+#[derive(Debug, Clone)]
+pub enum LinkEvent<'a> {
+    Link {
+        source: &'a str,
+        target: &'a Path,
+    },
+    Copy {
+        source: &'a str,
+        target: &'a Path,
+    },
+    Skip {
+        source: &'a str,
+        reason: &'a str,
+    },
+    Backup {
+        from: &'a Path,
+        to: &'a Path,
+    },
+    Remove {
+        target: &'a Path,
+    },
+    CreateDir {
+        path: &'a Path,
+    },
+    DryRun {
+        action: &'a str,
+        source: &'a str,
+        target: &'a Path,
+    },
+}
+
+/// Port for reporting link/unlink progress. Library code calls this
+/// instead of println!.
+pub trait Reporter {
+    fn report(&self, event: &LinkEvent<'_>);
+}
+
+/// No-op reporter for when output is unwanted.
+pub struct SilentReporter;
+
+impl Reporter for SilentReporter {
+    fn report(&self, _event: &LinkEvent<'_>) {}
+}
diff --git a/crates/notfiles/.DS_Store b/crates/notfiles/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..0d5609eae71284cdb133f7a8d00490aa0ab4e670
GIT binary patch
literal 6148
zcmeHKJ5B>J5S<}GT8SnlrB8qqxWE!E9SsTxh>{>Evf7A*hK8l&790VILvR-wC^!Ib
zJcDA36(tg6MzWthAJ6(pYkP=@M>q2!(SV2wG(na@hlsk<v}4X<WLaZ4o;CF{YBB#4
zBH!Ml6<yP8ahZPq!NbN<H&r!VG*f7b=l9$Dqqmpi)H?scy1YtPeMA`T(wZ)ib4{x(
zC!L+<)-><k)5rPYYs{O(*Uct(w@03TBKcjM0cXG&a0a%U0lTA%z3ryKckc{1104*=
z`4G?qOT$(%9v$dn2>|Rv9R*{lB_t*omWHh&ED+XEpoX%Q7_8yY2lFcpTSW~gw&H^=
z^H=f0F+0`|(Ve(d^xhe8266^^IvvRUe}Z48v&hdweC7-|1OJQx?pNb#giYDq`fYo1
w*9No+nuz$dGJs&5JpwS1b7Vgn)gELFztXT(lvP9@!-4(~h=h3O4EzEEpJmrbO8@`>

literal 0
HcmV?d00001

diff --git a/crates/notfiles/Cargo.toml b/crates/notfiles/Cargo.toml
index 417cb98..962796e 100644
--- a/crates/notfiles/Cargo.toml
+++ b/crates/notfiles/Cargo.toml
@@ -3,6 +3,10 @@ name    = "notfiles"
 version = "0.1.0"
 edition = "2024"
 license.workspace = true
+repository.workspace = true
+homepage.workspace = true
+keywords.workspace = true
+categories.workspace = true
 description = "A modern dotfiles manager — pure Rust alternative to GNU Stow"
 
 [[bin]]
@@ -16,9 +20,11 @@ path = "src/lib.rs"
 [dependencies]
 notcore  = { workspace = true }
 clap     = { workspace = true }
+clap_complete = { workspace = true }
 globset  = { workspace = true }
 chrono   = { workspace = true }
 serde    = { workspace = true }
+serde_json = { workspace = true }
 toml     = { workspace = true }
 anyhow   = { workspace = true }
 dirs     = { workspace = true }
diff --git a/crates/notfiles/src/adapters/memory.rs b/crates/notfiles/src/adapters/memory.rs
new file mode 100644
index 0000000..407bc96
--- /dev/null
+++ b/crates/notfiles/src/adapters/memory.rs
@@ -0,0 +1,293 @@
+use std::cell::RefCell;
+use std::collections::{HashMap, HashSet};
+use std::path::{Path, PathBuf};
+
+use crate::ports::FileStore;
+
+/// In-memory file system for testing. Not thread-safe.
+pub struct InMemoryFileStore {
+    files: RefCell<HashMap<PathBuf, Vec<u8>>>,
+    dirs: RefCell<HashSet<PathBuf>>,
+    symlinks: RefCell<HashMap<PathBuf, PathBuf>>,
+}
+
+impl InMemoryFileStore {
+    pub fn new() -> Self {
+        Self {
+            files: RefCell::new(HashMap::new()),
+            dirs: RefCell::new(HashSet::new()),
+            symlinks: RefCell::new(HashMap::new()),
+        }
+    }
+
+    pub fn add_file(&self, path: impl AsRef<Path>, content: &[u8]) {
+        let path = path.as_ref().to_path_buf();
+        // Ensure parent dirs exist
+        if let Some(parent) = path.parent() {
+            self.ensure_parents(parent);
+        }
+        self.files.borrow_mut().insert(path, content.to_vec());
+    }
+
+    pub fn add_dir(&self, path: impl AsRef<Path>) {
+        self.ensure_parents(path.as_ref());
+    }
+
+    pub fn has_symlink(&self, link: &Path) -> bool {
+        self.symlinks.borrow().contains_key(link)
+    }
+
+    pub fn symlink_target(&self, link: &Path) -> Option<PathBuf> {
+        self.symlinks.borrow().get(link).cloned()
+    }
+
+    fn ensure_parents(&self, path: &Path) {
+        let mut current = path.to_path_buf();
+        let mut dirs = self.dirs.borrow_mut();
+        loop {
+            if !dirs.insert(current.clone()) {
+                break;
+            }
+            match current.parent() {
+                Some(p) if p != current => current = p.to_path_buf(),
+                _ => break,
+            }
+        }
+    }
+}
+
+impl Default for InMemoryFileStore {
+    fn default() -> Self {
+        Self::new()
+    }
+}
+
+impl FileStore for InMemoryFileStore {
+    fn read(&self, path: &Path) -> Result<Vec<u8>, std::io::Error> {
+        // Follow symlinks
+        if let Some(target) = self.symlinks.borrow().get(path) {
+            return self.read(target);
+        }
+        self.files.borrow().get(path).cloned().ok_or_else(|| {
+            std::io::Error::new(std::io::ErrorKind::NotFound, path.display().to_string())
+        })
+    }
+
+    fn read_to_string(&self, path: &Path) -> Result<String, std::io::Error> {
+        let bytes = self.read(path)?;
+        String::from_utf8(bytes)
+            .map_err(|e| std::io::Error::new(std::io::ErrorKind::InvalidData, e))
+    }
+
+    fn write(&self, path: &Path, contents: &[u8]) -> Result<(), std::io::Error> {
+        if let Some(parent) = path.parent() {
+            self.ensure_parents(parent);
+        }
+        self.files
+            .borrow_mut()
+            .insert(path.to_path_buf(), contents.to_vec());
+        Ok(())
+    }
+
+    fn rename(&self, from: &Path, to: &Path) -> Result<(), std::io::Error> {
+        let content = self.files.borrow_mut().remove(from);
+        if let Some(content) = content {
+            if let Some(parent) = to.parent() {
+                self.ensure_parents(parent);
+            }
+            self.files.borrow_mut().insert(to.to_path_buf(), content);
+            return Ok(());
+        }
+        if self.symlinks.borrow_mut().remove(from).is_some() {
+            return Ok(());
+        }
+        Err(std::io::Error::new(
+            std::io::ErrorKind::NotFound,
+            from.display().to_string(),
+        ))
+    }
+
+    fn remove_file(&self, path: &Path) -> Result<(), std::io::Error> {
+        if self.files.borrow_mut().remove(path).is_some() {
+            return Ok(());
+        }
+        if self.symlinks.borrow_mut().remove(path).is_some() {
+            return Ok(());
+        }
+        Err(std::io::Error::new(
+            std::io::ErrorKind::NotFound,
+            path.display().to_string(),
+        ))
+    }
+
+    fn remove_dir_all(&self, path: &Path) -> Result<(), std::io::Error> {
+        let path = path.to_path_buf();
+        self.files.borrow_mut().retain(|k, _| !k.starts_with(&path));
+        self.dirs.borrow_mut().retain(|k| !k.starts_with(&path));
+        self.symlinks
+            .borrow_mut()
+            .retain(|k, _| !k.starts_with(&path));
+        Ok(())
+    }
+
+    fn remove_dir(&self, path: &Path) -> Result<(), std::io::Error> {
+        self.dirs.borrow_mut().remove(path);
+        Ok(())
+    }
+
+    fn read_link(&self, path: &Path) -> Result<PathBuf, std::io::Error> {
+        self.symlinks.borrow().get(path).cloned().ok_or_else(|| {
+            std::io::Error::new(std::io::ErrorKind::NotFound, path.display().to_string())
+        })
+    }
+
+    fn symlink_metadata(&self, path: &Path) -> Result<std::fs::Metadata, std::io::Error> {
+        // We can't construct real Metadata, but we can indicate existence
+        // by returning NotFound when the path doesn't exist
+        if self.files.borrow().contains_key(path)
+            || self.dirs.borrow().contains(path)
+            || self.symlinks.borrow().contains_key(path)
+        {
+            // Return metadata of a real temp file as a stand-in
+            // This is a known limitation of the in-memory store
+            Err(std::io::Error::other(
+                "InMemoryFileStore: metadata not available",
+            ))
+        } else {
+            Err(std::io::Error::new(
+                std::io::ErrorKind::NotFound,
+                path.display().to_string(),
+            ))
+        }
+    }
+
+    fn metadata(&self, path: &Path) -> Result<std::fs::Metadata, std::io::Error> {
+        self.symlink_metadata(path)
+    }
+
+    fn create_dir_all(&self, path: &Path) -> Result<(), std::io::Error> {
+        self.ensure_parents(path);
+        Ok(())
+    }
+
+    fn read_dir(&self, path: &Path) -> Result<Vec<PathBuf>, std::io::Error> {
+        let path = path.to_path_buf();
+        let mut children = Vec::new();
+
+        for key in self.files.borrow().keys() {
+            if key.parent() == Some(&path) {
+                children.push(key.clone());
+            }
+        }
+
+        for dir in self.dirs.borrow().iter() {
+            if dir.parent() == Some(&path) && dir != &path && !children.contains(dir) {
+                children.push(dir.clone());
+            }
+        }
+
+        for key in self.symlinks.borrow().keys() {
+            if key.parent() == Some(&path) && !children.contains(key) {
+                children.push(key.clone());
+            }
+        }
+
+        Ok(children)
+    }
+
+    #[cfg(unix)]
+    fn symlink(&self, target: &Path, link: &Path) -> Result<(), std::io::Error> {
+        if let Some(parent) = link.parent() {
+            self.ensure_parents(parent);
+        }
+        self.symlinks
+            .borrow_mut()
+            .insert(link.to_path_buf(), target.to_path_buf());
+        Ok(())
+    }
+
+    fn exists(&self, path: &Path) -> bool {
+        self.files.borrow().contains_key(path)
+            || self.dirs.borrow().contains(path)
+            || self.symlinks.borrow().contains_key(path)
+    }
+
+    fn is_dir(&self, path: &Path) -> bool {
+        self.dirs.borrow().contains(path)
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_add_file_creates_parents() {
+        let fs = InMemoryFileStore::new();
+        fs.add_file("/a/b/c.txt", b"hello");
+        assert!(fs.is_dir(Path::new("/a")));
+        assert!(fs.is_dir(Path::new("/a/b")));
+        assert!(fs.exists(Path::new("/a/b/c.txt")));
+    }
+
+    #[test]
+    fn test_read_write_roundtrip() {
+        let fs = InMemoryFileStore::new();
+        fs.write(Path::new("/tmp/f.txt"), b"data").unwrap();
+        assert_eq!(fs.read(Path::new("/tmp/f.txt")).unwrap(), b"data");
+        assert_eq!(fs.read_to_string(Path::new("/tmp/f.txt")).unwrap(), "data");
+    }
+
+    #[test]
+    fn test_symlink_roundtrip() {
+        let fs = InMemoryFileStore::new();
+        fs.add_file("/src/config", b"content");
+        fs.symlink(Path::new("/src/config"), Path::new("/home/config"))
+            .unwrap();
+        assert!(fs.has_symlink(Path::new("/home/config")));
+        assert_eq!(
+            fs.read_link(Path::new("/home/config")).unwrap(),
+            PathBuf::from("/src/config")
+        );
+        // Reading through symlink
+        assert_eq!(fs.read(Path::new("/home/config")).unwrap(), b"content");
+    }
+
+    #[test]
+    fn test_rename_file() {
+        let fs = InMemoryFileStore::new();
+        fs.add_file("/a.txt", b"hello");
+        fs.rename(Path::new("/a.txt"), Path::new("/b.txt")).unwrap();
+        assert!(!fs.exists(Path::new("/a.txt")));
+        assert_eq!(fs.read(Path::new("/b.txt")).unwrap(), b"hello");
+    }
+
+    #[test]
+    fn test_remove_dir_all() {
+        let fs = InMemoryFileStore::new();
+        fs.add_file("/dir/a.txt", b"a");
+        fs.add_file("/dir/sub/b.txt", b"b");
+        fs.remove_dir_all(Path::new("/dir")).unwrap();
+        assert!(!fs.exists(Path::new("/dir/a.txt")));
+        assert!(!fs.exists(Path::new("/dir/sub/b.txt")));
+        assert!(!fs.is_dir(Path::new("/dir")));
+    }
+
+    #[test]
+    fn test_read_dir_lists_children() {
+        let fs = InMemoryFileStore::new();
+        fs.add_file("/dir/a.txt", b"a");
+        fs.add_file("/dir/b.txt", b"b");
+        fs.add_dir("/dir/sub");
+        let mut children = fs.read_dir(Path::new("/dir")).unwrap();
+        children.sort();
+        assert_eq!(
+            children,
+            vec![
+                PathBuf::from("/dir/a.txt"),
+                PathBuf::from("/dir/b.txt"),
+                PathBuf::from("/dir/sub"),
+            ]
+        );
+    }
+}
diff --git a/crates/notfiles/src/adapters/mod.rs b/crates/notfiles/src/adapters/mod.rs
index c685f64..2b20901 100644
--- a/crates/notfiles/src/adapters/mod.rs
+++ b/crates/notfiles/src/adapters/mod.rs
@@ -1,3 +1,7 @@
 pub mod fs;
+pub mod memory;
+pub mod reporter;
 
 pub use fs::FileStoreImpl;
+pub use memory::InMemoryFileStore;
+pub use reporter::{JsonReporter, TerminalReporter};
diff --git a/crates/notfiles/src/adapters/reporter.rs b/crates/notfiles/src/adapters/reporter.rs
new file mode 100644
index 0000000..cedef52
--- /dev/null
+++ b/crates/notfiles/src/adapters/reporter.rs
@@ -0,0 +1,81 @@
+use serde_json::json;
+
+use notcore::reporter::{LinkEvent, Reporter};
+
+/// Terminal reporter with ANSI color output.
+pub struct TerminalReporter;
+
+/// JSON reporter: one JSON object per line to stdout.
+pub struct JsonReporter;
+
+impl Reporter for TerminalReporter {
+    fn report(&self, event: &LinkEvent<'_>) {
+        match event {
+            LinkEvent::Link { source, target } => {
+                println!("  \x1b[32mlink\x1b[0m {source} -> {}", target.display());
+            }
+            LinkEvent::Copy { source, target } => {
+                println!("  \x1b[32mcopy\x1b[0m {source} -> {}", target.display());
+            }
+            LinkEvent::Skip { source, reason } => {
+                println!("  \x1b[90mskip\x1b[0m {source} ({reason})");
+            }
+            LinkEvent::Backup { from, to } => {
+                println!(
+                    "  \x1b[33mbackup\x1b[0m {} -> {}",
+                    from.display(),
+                    to.display()
+                );
+            }
+            LinkEvent::Remove { target } => {
+                println!("  \x1b[31mremove\x1b[0m {}", target.display());
+            }
+            LinkEvent::CreateDir { path } => {
+                println!("  \x1b[90mcreate dir\x1b[0m {}", path.display());
+            }
+            LinkEvent::DryRun {
+                action,
+                source,
+                target,
+            } => {
+                println!(
+                    "  \x1b[36mwould {action}\x1b[0m {source} -> {}",
+                    target.display()
+                );
+            }
+        }
+    }
+}
+
+impl Reporter for JsonReporter {
+    fn report(&self, event: &LinkEvent<'_>) {
+        let obj = match event {
+            LinkEvent::Link { source, target } => {
+                json!({"event": "link", "source": source, "target": target.to_string_lossy()})
+            }
+            LinkEvent::Copy { source, target } => {
+                json!({"event": "copy", "source": source, "target": target.to_string_lossy()})
+            }
+            LinkEvent::Skip { source, reason } => {
+                json!({"event": "skip", "source": source, "reason": reason})
+            }
+            LinkEvent::Backup { from, to } => {
+                json!({"event": "backup", "from": from.to_string_lossy(), "to": to.to_string_lossy()})
+            }
+            LinkEvent::Remove { target } => {
+                json!({"event": "remove", "target": target.to_string_lossy()})
+            }
+            LinkEvent::CreateDir { path } => {
+                json!({"event": "create_dir", "path": path.to_string_lossy()})
+            }
+            LinkEvent::DryRun {
+                action,
+                source,
+                target,
+            } => {
+                json!({"event": "dry_run", "action": action, "source": source, "target": target.to_string_lossy()})
+            }
+        };
+        println!("{}", serde_json::to_string(&obj).unwrap_or_default());
+    }
+}
diff --git a/crates/notfiles/src/ignore.rs b/crates/notfiles/src/ignore.rs
index fd7d137..8251466 100644
--- a/crates/notfiles/src/ignore.rs
+++ b/crates/notfiles/src/ignore.rs
@@ -15,7 +15,7 @@ impl IgnoreMatcher {
             let glob = Glob::new(pattern)
                 .or_else(|_| Glob::new(&format!("**/{pattern}")))
                 .map_err(|e| {
-                    NotfilesError::Other(format!("invalid ignore pattern '{pattern}': {e}"))
+                    NotfilesError::Glob(format!("invalid ignore pattern '{pattern}': {e}"))
                 })?;
             builder.add(glob);
             // Also add a recursive variant so "foo" matches "a/foo" etc.
@@ -28,7 +28,7 @@ impl IgnoreMatcher {
         }
         let globset = builder
             .build()
-            .map_err(|e| NotfilesError::Other(format!("building ignore set: {e}")))?;
+            .map_err(|e| NotfilesError::Glob(format!("building ignore set: {e}")))?;
         Ok(Self { globset })
     }
 
diff --git a/crates/notfiles/src/linker.rs b/crates/notfiles/src/linker.rs
index 8decd7f..dadc305 100644
--- a/crates/notfiles/src/linker.rs
+++ b/crates/notfiles/src/linker.rs
@@ -5,6 +5,7 @@ use serde::{Deserialize, Serialize};
 
 use crate::package::collect_files_with_store;
 use crate::ports::FileStore;
+use notcore::reporter::{LinkEvent, Reporter};
 use notcore::{Config, Method, NotfilesError, expand_tilde};
 
 const STATE_FILE: &str = ".notfiles-state.toml";
@@ -81,6 +82,15 @@ pub struct LinkOptions {
     pub verbose: bool,
 }
 
+#[derive(Debug, Default)]
+pub struct LinkResult {
+    pub package: String,
+    pub linked: usize,
+    pub copied: usize,
+    pub skipped: usize,
+    pub backed_up: usize,
+}
+
 pub fn link_package(
     dotfiles_dir: &Path,
     config: &Config,
@@ -88,17 +98,23 @@ pub fn link_package(
     package: &str,
     opts: &LinkOptions,
     fs: &dyn FileStore,
-) -> Result<(), NotfilesError> {
+    reporter: &dyn Reporter,
+) -> Result<LinkResult, NotfilesError> {
     let package_dir = dotfiles_dir.join(package);
     let method = config.method_for(package);
     let target_base = expand_tilde(config.target_for(package))?;
     let files = collect_files_with_store(&package_dir, config, package, fs)?;
+    let mut result = LinkResult {
+        package: package.to_string(),
+        ..Default::default()
+    };
 
     if files.is_empty() {
-        if opts.verbose {
-            println!("  {package}: no files to link");
-        }
-        return Ok(());
+        reporter.report(&LinkEvent::Skip {
+            source: package,
+            reason: "no files to link",
+        });
+        return Ok(result);
     }
 
     for relative in &files {
@@ -108,19 +124,22 @@ pub fn link_package(
 
         // Check if already correctly linked / copied
         if is_already_linked(&source, &target, method, fs) {
-            if opts.verbose {
-                println!("  \x1b[90mskip\x1b[0m {source_display} (already linked)");
-            }
+            reporter.report(&LinkEvent::Skip {
+                source: &source_display,
+                reason: "already linked",
+            });
+            result.skipped += 1;
             continue;
         }
 
         // Helper: save partial state then return an error.
-        let save_and_return = |state: &mut State, e: NotfilesError| -> Result<(), NotfilesError> {
-            if !opts.dry_run {
-                let _ = state.save(dotfiles_dir, fs);
-            }
-            Err(e)
-        };
+        let save_and_return =
+            |state: &mut State, e: NotfilesError| -> Result<LinkResult, NotfilesError> {
+                if !opts.dry_run {
+                    let _ = state.save(dotfiles_dir, fs);
+                }
+                Err(e)
+            };
 
         // Conflict detection
         if fs.exists(&target) || fs.symlink_metadata(&target).is_ok() {
@@ -139,22 +158,20 @@ pub fn link_package(
             if !opts.no_backup {
                 let backup = backup_path(&target);
                 if opts.dry_run {
-                    println!(
-                        "  \x1b[33mwould backup\x1b[0m {} -> {}",
-                        target.display(),
-                        backup.display()
-                    );
+                    reporter.report(&LinkEvent::DryRun {
+                        action: "backup",
+                        source: &source_display,
+                        target: &backup,
+                    });
                 } else {
-                    if opts.verbose {
-                        println!(
-                            "  \x1b[33mbackup\x1b[0m {} -> {}",
-                            target.display(),
-                            backup.display()
-                        );
-                    }
+                    reporter.report(&LinkEvent::Backup {
+                        from: &target,
+                        to: &backup,
+                    });
                     if let Err(e) = fs.rename(&target, &backup) {
                         return save_and_return(state, e.into());
                     }
+                    result.backed_up += 1;
                 }
             } else if !opts.dry_run {
                 let rm_result = if fs.is_dir(&target) {
@@ -171,9 +188,7 @@ pub fn link_package(
         // Create parent directories
         if let Some(parent) = target.parent().filter(|p| !fs.exists(p)) {
             if opts.dry_run {
-                if opts.verbose {
-                    println!("  \x1b[90mwould create dir\x1b[0m {}", parent.display());
-                }
+                reporter.report(&LinkEvent::CreateDir { path: parent });
             } else if let Err(e) = fs.create_dir_all(parent) {
                 return save_and_return(state, e.into());
             }
@@ -186,12 +201,13 @@ pub fn link_package(
         };
 
         if opts.dry_run {
-            println!(
-                "  \x1b[36mwould {action_word}\x1b[0m {source_display} -> {}",
-                target.display()
-            );
+            reporter.report(&LinkEvent::DryRun {
+                action: action_word,
+                source: &source_display,
+                target: &target,
+            });
         } else {
-            let link_result = match method {
+            let io_result = match method {
                 Method::Symlink => {
                     #[cfg(unix)]
                     {
@@ -210,14 +226,24 @@ pub fn link_package(
                     fs.write(&target, &content).map(|_| content.len() as u64)
                 }
             };
-            if let Err(e) = link_result {
+            if let Err(e) = io_result {
                 return save_and_return(state, e.into());
             }
-            if opts.verbose {
-                println!(
-                    "  \x1b[32m{action_word}\x1b[0m {source_display} -> {}",
-                    target.display()
-                );
+            match method {
+                Method::Symlink => {
+                    reporter.report(&LinkEvent::Link {
+                        source: &source_display,
+                        target: &target,
+                    });
+                    result.linked += 1;
+                }
+                Method::Copy => {
+                    reporter.report(&LinkEvent::Copy {
+                        source: &source_display,
+                        target: &target,
+                    });
+                    result.copied += 1;
+                }
             }
 
             state.add_entry(StateEntry {
@@ -233,7 +259,7 @@ pub fn link_package(
     if !opts.dry_run {
         state.save(dotfiles_dir, fs)?;
     }
-    Ok(())
+    Ok(result)
 }
 
 pub fn unlink_package(
@@ -242,6 +268,7 @@ pub fn unlink_package(
     package: &str,
     opts: &LinkOptions,
     fs: &dyn FileStore,
+    reporter: &dyn Reporter,
 ) -> Result<(), NotfilesError> {
     // Validate the package: it must either exist as a directory in dotfiles_dir
     // or have entries in state.  A name that satisfies neither is a user error.
@@ -260,9 +287,10 @@ pub fn unlink_package(
         .collect();
 
     if entries.is_empty() {
-        if opts.verbose {
-            println!("  {package}: nothing to unlink");
-        }
+        reporter.report(&LinkEvent::Skip {
+            source: package,
+            reason: "nothing to unlink",
+        });
         return Ok(());
     }
 
@@ -273,9 +301,10 @@ pub fn unlink_package(
         let source = PathBuf::from(&entry.source);
 
         if !fs.exists(&target) && fs.symlink_metadata(&target).is_err() {
-            if opts.verbose {
-                println!("  \x1b[90mskip\x1b[0m {} (already gone)", target.display());
-            }
+            reporter.report(&LinkEvent::Skip {
+                source: &target.to_string_lossy(),
+                reason: "already gone",
+            });
             if !opts.dry_run {
                 removed_entries.push((entry.source.clone(), entry.target.clone()));
             }
@@ -287,64 +316,59 @@ pub fn unlink_package(
                 // Verify it's a symlink pointing to our source
                 if let Ok(link_target) = fs.read_link(&target) {
                     if link_target != source {
-                        if opts.verbose {
-                            println!(
-                                "  \x1b[33mskip\x1b[0m {} (symlink points elsewhere)",
-                                target.display()
-                            );
-                        }
+                        reporter.report(&LinkEvent::Skip {
+                            source: &target.to_string_lossy(),
+                            reason: "symlink points elsewhere",
+                        });
                         continue;
                     }
                 } else {
-                    if opts.verbose {
-                        println!("  \x1b[33mskip\x1b[0m {} (not a symlink)", target.display());
-                    }
+                    reporter.report(&LinkEvent::Skip {
+                        source: &target.to_string_lossy(),
+                        reason: "not a symlink",
+                    });
                     continue;
                 }
             }
             Method::Copy => match (fs.read(&source), fs.read(&target)) {
                 (Ok(source_bytes), Ok(target_bytes)) if source_bytes == target_bytes => {}
                 (Ok(_), Ok(_)) => {
-                    if opts.verbose {
-                        println!(
-                            "  \x1b[33mskip\x1b[0m {} (copied file diverged from source)",
-                            target.display()
-                        );
-                    }
+                    reporter.report(&LinkEvent::Skip {
+                        source: &target.to_string_lossy(),
+                        reason: "copied file diverged from source",
+                    });
                     continue;
                 }
                 (Err(_), _) => {
-                    if opts.verbose {
-                        println!(
-                            "  \x1b[33mskip\x1b[0m {} (source missing for copied file)",
-                            target.display()
-                        );
-                    }
+                    reporter.report(&LinkEvent::Skip {
+                        source: &target.to_string_lossy(),
+                        reason: "source missing for copied file",
+                    });
                     continue;
                 }
                 (_, Err(_)) => {
-                    if opts.verbose {
-                        println!(
-                            "  \x1b[33mskip\x1b[0m {} (cannot read copied target)",
-                            target.display()
-                        );
-                    }
+                    reporter.report(&LinkEvent::Skip {
+                        source: &target.to_string_lossy(),
+                        reason: "cannot read copied target",
+                    });
                     continue;
                 }
             },
         }
 
         if opts.dry_run {
-            println!("  \x1b[36mwould remove\x1b[0m {}", target.display());
+            reporter.report(&LinkEvent::DryRun {
+                action: "remove",
+                source: &target.to_string_lossy(),
+                target: &target,
+            });
         } else {
             if fs.is_dir(&target) {
                 fs.remove_dir_all(&target)?;
             } else {
                 fs.remove_file(&target)?;
             }
-            if opts.verbose {
-                println!("  \x1b[31mremove\x1b[0m {}", target.display());
-            }
+            reporter.report(&LinkEvent::Remove { target: &target });
 
             // Clean up empty parent dirs
             cleanup_empty_parents(&target, fs);
@@ -362,6 +386,100 @@ pub fn unlink_package(
     Ok(())
 }
 
+#[allow(clippy::too_many_arguments)]
+pub fn adopt_files(
+    dotfiles_dir: &Path,
+    config: &Config,
+    state: &mut State,
+    package: &str,
+    files: &[String],
+    opts: &LinkOptions,
+    fs: &dyn FileStore,
+    reporter: &dyn Reporter,
+) -> Result<LinkResult, NotfilesError> {
+    let package_dir = dotfiles_dir.join(package);
+    let target_base = expand_tilde(config.target_for(package))?;
+    let mut result = LinkResult {
+        package: package.to_string(),
+        ..Default::default()
+    };
+
+    if !fs.is_dir(&package_dir) {
+        if opts.dry_run {
+            reporter.report(&LinkEvent::CreateDir { path: &package_dir });
+        } else {
+            fs.create_dir_all(&package_dir)?;
+        }
+    }
+
+    for file in files {
+        let relative = PathBuf::from(file);
+        let target = target_base.join(&relative);
+        let source = package_dir.join(&relative);
+        let display = format!("{package}/{}", relative.display());
+
+        if !fs.exists(&target) {
+            reporter.report(&LinkEvent::Skip {
+                source: &display,
+                reason: "target file does not exist",
+            });
+            result.skipped += 1;
+            continue;
+        }
+
+        if fs.exists(&source) {
+            reporter.report(&LinkEvent::Skip {
+                source: &display,
+                reason: "already exists in package",
+            });
+            result.skipped += 1;
+            continue;
+        }
+
+        if opts.dry_run {
+            reporter.report(&LinkEvent::DryRun {
+                action: "adopt",
+                source: &display,
+                target: &target,
+            });
+            continue;
+        }
+
+        // Create parent dirs in package
+        if let Some(parent) = source.parent().filter(|p| !fs.exists(p)) {
+            fs.create_dir_all(parent)?;
+        }
+
+        // Move target -> package source
+        fs.rename(&target, &source)?;
+
+        // Create symlink target -> source
+        #[cfg(unix)]
+        {
+            fs.symlink(&source, &target)?;
+        }
+
+        reporter.report(&LinkEvent::Link {
+            source: &display,
+            target: &target,
+        });
+
+        state.add_entry(StateEntry {
+            package: package.to_string(),
+            source: source.to_string_lossy().to_string(),
+            target: target.to_string_lossy().to_string(),
+            method: Method::Symlink,
+            linked_at: Utc::now().to_rfc3339(),
+        });
+        result.linked += 1;
+    }
+
+    if !opts.dry_run {
+        state.save(dotfiles_dir, fs)?;
+    }
+    Ok(result)
+}
+
 fn is_already_linked(source: &Path, target: &Path, method: Method, fs: &dyn FileStore) -> bool {
     match method {
         Method::Symlink => {
diff --git a/crates/notfiles/src/package.rs b/crates/notfiles/src/package.rs
index 20ae72e..9128946 100644
--- a/crates/notfiles/src/package.rs
+++ b/crates/notfiles/src/package.rs
@@ -5,6 +5,38 @@ use crate::ignore::IgnoreMatcher;
 use crate::ports::FileStore;
 use notcore::{Config, NotfilesError};
 
+/// Discover packages filtered by the config's include/exclude lists and
+/// platform constraints.
+pub fn discover_packages_filtered(
+    dotfiles_dir: &Path,
+    config: &Config,
+) -> Result<Vec<String>, NotfilesError> {
+    discover_packages_filtered_with_store(dotfiles_dir, config, &FileStoreImpl)
+}
+
+pub fn discover_packages_filtered_with_store(
+    dotfiles_dir: &Path,
+    config: &Config,
+    fs: &dyn FileStore,
+) -> Result<Vec<String>, NotfilesError> {
+    let all = discover_packages_with_store(dotfiles_dir, fs)?;
+    let filtered: Vec<String> = if let Some(include) = config.included_packages() {
+        all.into_iter()
+            .filter(|p| include.contains(&p.as_str()))
+            .collect()
+    } else {
+        all.into_iter()
+            .filter(|p| !config.is_package_excluded(p))
+            .collect()
+    };
+    // Apply platform filter
+    let filtered = filtered
+        .into_iter()
+        .filter(|p| config.is_package_for_current_platform(p))
+        .collect();
+    Ok(filtered)
+}
+
 /// Discover available packages (subdirectories of the dotfiles dir).
 pub fn discover_packages(dotfiles_dir: &Path) -> Result<Vec<String>, NotfilesError> {
     discover_packages_with_store(dotfiles_dir, &FileStoreImpl)
@@ -48,13 +80,28 @@ pub fn resolve_packages_with_store(
     requested: &[String],
     fs: &dyn FileStore,
 ) -> Result<Vec<String>, NotfilesError> {
-    let available = discover_packages_with_store(dotfiles_dir, fs)?;
+    resolve_packages_filtered_with_store(dotfiles_dir, requested, &Config::default(), fs)
+}
+
+pub fn resolve_packages_filtered_with_store(
+    dotfiles_dir: &Path,
+    requested: &[String],
+    config: &Config,
+    fs: &dyn FileStore,
+) -> Result<Vec<String>, NotfilesError> {
+    let available = discover_packages_filtered_with_store(dotfiles_dir, config, fs)?;
     if requested.is_empty() {
         return Ok(available);
     }
     for name in requested {
         if !available.contains(name) {
-            return Err(NotfilesError::PackageNotFound { name: name.clone() });
+            let available_refs: Vec<&str> = available.iter().map(|s| s.as_str()).collect();
+            let suggestion = notcore::suggest_package(name, &available_refs);
+            let mut msg = name.clone();
+            if let Some(s) = suggestion {
+                msg = format!("{name} (did you mean '{s}'?)");
+            }
+            return Err(NotfilesError::PackageNotFound { name: msg });
         }
     }
     Ok(requested.to_vec())
@@ -123,6 +170,40 @@ mod tests {
         assert_eq!(pkgs, vec!["git", "zsh"]);
     }
 
+    #[test]
+    fn test_discover_respects_include_filter() {
+        let tmp = TempDir::new().unwrap();
+        fs::create_dir(tmp.path().join("git")).unwrap();
+        fs::create_dir(tmp.path().join("zsh")).unwrap();
+        fs::create_dir(tmp.path().join("scripts")).unwrap();
+
+        let toml_str = r#"
+[defaults]
+target = "~"
+include = ["git", "zsh"]
+"#;
+        let config: Config = toml::from_str(toml_str).unwrap();
+        let pkgs = discover_packages_filtered(tmp.path(), &config).unwrap();
+        assert_eq!(pkgs, vec!["git", "zsh"]);
+    }
+
+    #[test]
+    fn test_discover_respects_exclude_filter() {
+        let tmp = TempDir::new().unwrap();
+        fs::create_dir(tmp.path().join("git")).unwrap();
+        fs::create_dir(tmp.path().join("scripts")).unwrap();
+        fs::create_dir(tmp.path().join("docs")).unwrap();
+
+        let toml_str = r#"
+[defaults]
+target = "~"
+exclude = ["scripts", "docs"]
+"#;
+        let config: Config = toml::from_str(toml_str).unwrap();
+        let pkgs = discover_packages_filtered(tmp.path(), &config).unwrap();
+        assert_eq!(pkgs, vec!["git"]);
+    }
+
     #[test]
     fn test_resolve_specific_packages() {
         let tmp = TempDir::new().unwrap();
diff --git a/crates/notfiles/src/status.rs b/crates/notfiles/src/status.rs
index 2327b82..a09e8db 100644
--- a/crates/notfiles/src/status.rs
+++ b/crates/notfiles/src/status.rs
@@ -1,5 +1,7 @@
 use std::path::{Path, PathBuf};
 
+use serde_json::json;
+
 use crate::linker::State;
 use crate::package::collect_files_with_store;
 use crate::ports::FileStore;
@@ -121,6 +123,126 @@ pub fn package_status(
     results
 }
 
+#[derive(Debug, PartialEq)]
+pub enum DiffKind {
+    Identical,
+    Modified,
+    SourceOnly,
+    TargetOnly,
+}
+
+pub struct DiffEntry {
+    pub source_display: String,
+    pub target: PathBuf,
+    pub kind: DiffKind,
+}
+
+pub fn diff_package(
+    dotfiles_dir: &Path,
+    config: &Config,
+    state: &State,
+    package: &str,
+    fs: &dyn FileStore,
+) -> Vec<DiffEntry> {
+    let mut results = Vec::new();
+    let method = config.method_for(package);
+    if method != Method::Copy {
+        return results;
+    }
+
+    let package_dir = dotfiles_dir.join(package);
+    let target_base = match expand_tilde(config.target_for(package)) {
+        Ok(p) => p,
+        Err(_) => return results,
+    };
+
+    // Check files tracked in state for this package
+    for entry in state.entries_for_package(package) {
+        let source = PathBuf::from(&entry.source);
+        let target = PathBuf::from(&entry.target);
+        let source_display = format!(
+            "{package}/{}",
+            source
+                .strip_prefix(&package_dir)
+                .unwrap_or(&source)
+                .display()
+        );
+
+        let kind = match (fs.read(&source), fs.read(&target)) {
+            (Ok(src), Ok(tgt)) => {
+                if src == tgt {
+                    DiffKind::Identical
+                } else {
+                    DiffKind::Modified
+                }
+            }
+            (Ok(_), Err(_)) => DiffKind::SourceOnly,
+            (Err(_), Ok(_)) => DiffKind::TargetOnly,
+            (Err(_), Err(_)) => continue,
+        };
+
+        results.push(DiffEntry {
+            source_display,
+            target,
+            kind,
+        });
+    }
+
+    // Also check untracked files from the package dir
+    if let Ok(files) = collect_files_with_store(&package_dir, config, package, fs) {
+        for relative in &files {
+            let source = package_dir.join(relative);
+            let target = target_base.join(relative);
+            // Skip if already covered by state entries
+            if results.iter().any(|r| r.target == target) {
+                continue;
+            }
+            let source_display = format!("{package}/{}", relative.display());
+            let kind = if !fs.exists(&target) {
+                DiffKind::SourceOnly
+            } else {
+                match (fs.read(&source), fs.read(&target)) {
+                    (Ok(src), Ok(tgt)) if src == tgt => DiffKind::Identical,
+                    (Ok(_), Ok(_)) => DiffKind::Modified,
+                    _ => continue,
+                }
+            };
+            results.push(DiffEntry {
+                source_display,
+                target,
+                kind,
+            });
+        }
+    }
+
+    results
+}
+
+pub fn print_diff(package: &str, entries: &[DiffEntry]) {
+    let non_identical: Vec<_> = entries
+        .iter()
+        .filter(|e| e.kind != DiffKind::Identical)
+        .collect();
+    if non_identical.is_empty() {
+        println!("  {package}: all copies identical");
+        return;
+    }
+    println!("  \x1b[1m{package}\x1b[0m:");
+    for entry in &non_identical {
+        let label = match entry.kind {
+            DiffKind::Modified => "\x1b[33mmodified\x1b[0m",
+            DiffKind::SourceOnly => "\x1b[36msource only\x1b[0m",
+            DiffKind::TargetOnly => "\x1b[35mtarget only\x1b[0m",
+            DiffKind::Identical => unreachable!(),
+        };
+        println!(
+            "    {label} {} -> {}",
+            entry.source_display,
+            entry.target.display()
+        );
+    }
+}
+
 pub fn print_status(package: &str, entries: &[StatusEntry]) {
     if entries.is_empty() {
         println!("  {package}: (empty)");
@@ -136,3 +258,18 @@ pub fn print_status(package: &str, entries: &[StatusEntry]) {
         );
     }
 }
+
+pub fn print_status_json(package: &str, entries: &[StatusEntry]) {
+    let items: Vec<_> = entries
+        .iter()
+        .map(|e| {
+            json!({
+                "source": e.source_display,
+                "target": e.target.to_string_lossy(),
+                "status": format!("{:?}", e.status).to_lowercase(),
+            })
+        })
+        .collect();
+    let obj = json!({"package": package, "entries": items});
+    println!("{}", serde_json::to_string(&obj).unwrap_or_default());
+}
diff --git a/crates/notfiles/tests/fixtures/dotfiles/README.md b/crates/notfiles/tests/fixtures/dotfiles/README.md
new file mode 100644
index 0000000..52e0158
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/README.md
@@ -0,0 +1,23 @@
+# Test Fixture — Dotfiles
+
+This directory is a test fixture representing a realistic dotfiles repo.
+It is used by notfiles integration tests and serves as an example of the
+expected directory structure.
+
+## Package directories (linked to ~)
+
+- `git/` — `.gitconfig` at root
+- `zsh/` — `.zshrc` at root
+- `nushell/` — `.config/nushell/` tree
+- `starship/` — `.config/starship.toml`
+- `alacritty/` — `.config/alacritty/alacritty.toml`
+- `mise/` — `.config/mise/config.toml`
+- `fish/` — `.config/fish/config.fish`
+- `nixos/` — platform-gated to Linux only
+- `vscode/` — deep `Library/Application Support/` path (macOS)
+
+## Non-package directories (excluded via include list)
+
+- `scripts/` — shell scripts, not a stow target
+- `docs/` — documentation
+- `secrets/` — encrypted env files, copy-only with ignore
diff --git a/crates/notfiles/tests/fixtures/dotfiles/alacritty/.config/alacritty/alacritty.toml b/crates/notfiles/tests/fixtures/dotfiles/alacritty/.config/alacritty/alacritty.toml
new file mode 100644
index 0000000..b301e49
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/alacritty/.config/alacritty/alacritty.toml
@@ -0,0 +1,2 @@
+[font]
+size = 14.0
diff --git a/crates/notfiles/tests/fixtures/dotfiles/docs/bootstrap-runbook.md b/crates/notfiles/tests/fixtures/dotfiles/docs/bootstrap-runbook.md
new file mode 100644
index 0000000..34d4ba6
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/docs/bootstrap-runbook.md
@@ -0,0 +1,3 @@
+# Bootstrap Runbook
+
+Steps for setting up a new machine.
diff --git a/crates/notfiles/tests/fixtures/dotfiles/fish/.config/fish/config.fish b/crates/notfiles/tests/fixtures/dotfiles/fish/.config/fish/config.fish
new file mode 100644
index 0000000..bb807a8
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/fish/.config/fish/config.fish
@@ -0,0 +1,2 @@
+# Example fish config
+set -gx EDITOR nvim
diff --git a/crates/notfiles/tests/fixtures/dotfiles/git/.gitconfig b/crates/notfiles/tests/fixtures/dotfiles/git/.gitconfig
new file mode 100644
index 0000000..ab81155
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/git/.gitconfig
@@ -0,0 +1,5 @@
+[user]
+    name = Example User
+    email = user@example.com
+[init]
+    defaultBranch = main
diff --git a/crates/notfiles/tests/fixtures/dotfiles/mise/.config/mise/config.toml b/crates/notfiles/tests/fixtures/dotfiles/mise/.config/mise/config.toml
new file mode 100644
index 0000000..377ec7c
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/mise/.config/mise/config.toml
@@ -0,0 +1,2 @@
+[tools]
+node = "lts"
diff --git a/crates/notfiles/tests/fixtures/dotfiles/nixos/configuration.nix b/crates/notfiles/tests/fixtures/dotfiles/nixos/configuration.nix
new file mode 100644
index 0000000..7d773d7
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/nixos/configuration.nix
@@ -0,0 +1,4 @@
+{ config, pkgs, ... }:
+{
+  environment.systemPackages = with pkgs; [ vim git ];
+}
diff --git a/crates/notfiles/tests/fixtures/dotfiles/notfiles.toml b/crates/notfiles/tests/fixtures/dotfiles/notfiles.toml
new file mode 100644
index 0000000..291274f
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/notfiles.toml
@@ -0,0 +1,34 @@
+# Example notfiles.toml — mirrors a realistic dotfiles repo.
+#
+# This fixture is used by integration tests and serves as documentation
+# for how to configure notfiles with a mixed-purpose dotfiles repo.
+
+[defaults]
+target = "~"
+ignore = [".git", ".DS_Store", "README.md", "LICENSE", "notfiles.toml", ".notfiles-state.toml", ".nothooks-state.toml"]
+
+# Only link actual stow packages — skip operational dirs.
+include = ["git", "zsh", "nushell", "starship", "alacritty", "mise", "fish", "nixos", "vscode"]
+
+[packages.git]
+
+[packages.zsh]
+
+[packages.nushell]
+
+[packages.starship]
+
+[packages.alacritty]
+
+[packages.mise]
+
+[packages.fish]
+
+[packages.nixos]
+platforms = ["linux"]
+
+[packages.vscode]
+
+[packages.secrets]
+method = "copy"
+ignore = ["*.example"]
diff --git a/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/autoload/aliases.nu b/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/autoload/aliases.nu
new file mode 100644
index 0000000..fd0a07b
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/autoload/aliases.nu
@@ -0,0 +1,2 @@
+# Example aliases
+alias ll = ls -l
diff --git a/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/config.nu b/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/config.nu
new file mode 100644
index 0000000..825658d
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/config.nu
@@ -0,0 +1,2 @@
+# Example nushell config
+$env.config.show_banner = false
diff --git a/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/env.nu b/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/env.nu
new file mode 100644
index 0000000..6ee3c39
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/nushell/.config/nushell/env.nu
@@ -0,0 +1,2 @@
+# Example nushell env
+$env.EDITOR = "nvim"
diff --git a/crates/notfiles/tests/fixtures/dotfiles/scripts/doctor.sh b/crates/notfiles/tests/fixtures/dotfiles/scripts/doctor.sh
new file mode 100644
index 0000000..5a056ad
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/scripts/doctor.sh
@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# Health check script — NOT a stow package.
+echo "All good"
diff --git a/crates/notfiles/tests/fixtures/dotfiles/scripts/lib/common.sh b/crates/notfiles/tests/fixtures/dotfiles/scripts/lib/common.sh
new file mode 100644
index 0000000..29b12b2
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/scripts/lib/common.sh
@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# Shared helpers — NOT a stow package.
+log() { echo "[$(date)] $*"; }
diff --git a/crates/notfiles/tests/fixtures/dotfiles/secrets/.env.json.example b/crates/notfiles/tests/fixtures/dotfiles/secrets/.env.json.example
new file mode 100644
index 0000000..fc3dbf5
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/secrets/.env.json.example
@@ -0,0 +1,3 @@
+{
+  "EXAMPLE_KEY": "replace-me"
+}
diff --git a/crates/notfiles/tests/fixtures/dotfiles/starship/.config/starship.toml b/crates/notfiles/tests/fixtures/dotfiles/starship/.config/starship.toml
new file mode 100644
index 0000000..12d3af4
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/starship/.config/starship.toml
@@ -0,0 +1,2 @@
+[character]
+success_symbol = "[>](bold green)"
diff --git a/crates/notfiles/tests/fixtures/dotfiles/vscode/Library/Application Support/Code/User/settings.json b/crates/notfiles/tests/fixtures/dotfiles/vscode/Library/Application Support/Code/User/settings.json
new file mode 100644
index 0000000..91ed194
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/vscode/Library/Application Support/Code/User/settings.json	
@@ -0,0 +1,4 @@
+{
+  "editor.fontSize": 14,
+  "editor.tabSize": 2
+}
diff --git a/crates/notfiles/tests/fixtures/dotfiles/zsh/.zshrc b/crates/notfiles/tests/fixtures/dotfiles/zsh/.zshrc
new file mode 100644
index 0000000..dbd9545
--- /dev/null
+++ b/crates/notfiles/tests/fixtures/dotfiles/zsh/.zshrc
@@ -0,0 +1,2 @@
+# Example zshrc
+export EDITOR=nvim
diff --git a/crates/notfiles/tests/integration.rs b/crates/notfiles/tests/integration.rs
index cd69f60..a63d7dc 100644
--- a/crates/notfiles/tests/integration.rs
+++ b/crates/notfiles/tests/integration.rs
@@ -463,3 +463,164 @@ fn test_unlink_cleans_empty_dirs() {
     // The .config/zsh directory should be cleaned up
     assert!(!target.join(".config/zsh").exists());
 }
+
+// ── Fixture-based tests ─────────────────────────────────────────────────────
+
+/// Copy the static fixture into a temp dir with a rewritten target, so tests
+/// don't touch the real home directory.
+fn setup_from_fixture(tmp: &TempDir) {
+    let fixture = Path::new(env!("CARGO_MANIFEST_DIR")).join("tests/fixtures/dotfiles");
+    let dotfiles = tmp.path().join("dotfiles");
+    let target = tmp.path().join("home");
+    fs::create_dir_all(&target).unwrap();
+    copy_dir_recursive(&fixture, &dotfiles).unwrap();
+
+    // Rewrite notfiles.toml to point target at our temp home
+    let config_path = dotfiles.join("notfiles.toml");
+    let content = fs::read_to_string(&config_path).unwrap();
+    let rewritten = content.replace(
+        "target = \"~\"",
+        &format!("target = \"{}\"", target.display()),
+    );
+    fs::write(&config_path, rewritten).unwrap();
+}
+
+fn copy_dir_recursive(src: &Path, dst: &Path) -> std::io::Result<()> {
+    fs::create_dir_all(dst)?;
+    for entry in fs::read_dir(src)? {
+        let entry = entry?;
+        let src_path = entry.path();
+        let dst_path = dst.join(entry.file_name());
+        if src_path.is_dir() {
+            copy_dir_recursive(&src_path, &dst_path)?;
+        } else {
+            fs::copy(&src_path, &dst_path)?;
+        }
+    }
+    Ok(())
+}
+
+#[test]
+fn test_fixture_include_excludes_non_packages() {
+    let tmp = TempDir::new().unwrap();
+    setup_from_fixture(&tmp);
+    let dotfiles = tmp.path().join("dotfiles");
+    let target = tmp.path().join("home");
+
+    let (_, _, ok) = run(&dotfiles, &["link"]);
+    assert!(ok);
+
+    // Stow packages should be linked
+    assert!(
+        target.join(".gitconfig").exists(),
+        ".gitconfig should be linked"
+    );
+    assert!(target.join(".zshrc").exists(), ".zshrc should be linked");
+    assert!(
+        target.join(".config/nushell/config.nu").exists(),
+        "nushell config should be linked",
+    );
+    assert!(
+        target.join(".config/starship.toml").exists(),
+        "starship config should be linked",
+    );
+
+    // Non-package dirs should NOT be linked
+    assert!(
+        !target.join("lib/common.sh").exists(),
+        "scripts/ should not be linked",
+    );
+    assert!(
+        !target.join("bootstrap-runbook.md").exists(),
+        "docs/ should not be linked",
+    );
+    assert!(
+        !target.join("doctor.sh").exists(),
+        "scripts/ should not be linked",
+    );
+}
+
+#[test]
+fn test_fixture_status_shows_all_packages() {
+    let tmp = TempDir::new().unwrap();
+    setup_from_fixture(&tmp);
+    let dotfiles = tmp.path().join("dotfiles");
+
+    let (stdout, _, ok) = run(&dotfiles, &["status"]);
+    assert!(ok);
+
+    // Should list stow packages
+    assert!(stdout.contains("git"), "status should show git package");
+    assert!(stdout.contains("zsh"), "status should show zsh package");
+    assert!(
+        stdout.contains("nushell"),
+        "status should show nushell package"
+    );
+
+    // Should NOT list excluded dirs
+    assert!(
+        !stdout.contains("scripts"),
+        "status should not show scripts"
+    );
+    assert!(!stdout.contains("docs"), "status should not show docs");
+}
+
+#[test]
+fn test_fixture_deep_paths_link_correctly() {
+    let tmp = TempDir::new().unwrap();
+    setup_from_fixture(&tmp);
+    let dotfiles = tmp.path().join("dotfiles");
+    let target = tmp.path().join("home");
+
+    let (_, _, ok) = run(&dotfiles, &["link", "vscode"]);
+    assert!(ok);
+
+    let vscode_settings = target.join("Library/Application Support/Code/User/settings.json");
+    assert!(
+        vscode_settings.exists(),
+        "deep path should be linked: {}",
+        vscode_settings.display(),
+    );
+}
+
+#[test]
+fn test_fixture_platform_filter_skips_linux_on_macos() {
+    if !cfg!(target_os = "macos") {
+        return; // This test is macOS-specific
+    }
+    let tmp = TempDir::new().unwrap();
+    setup_from_fixture(&tmp);
+    let dotfiles = tmp.path().join("dotfiles");
+    let target = tmp.path().join("home");
+
+    let (_, _, ok) = run(&dotfiles, &["link"]);
+    assert!(ok);
+
+    // nixos has platforms = ["linux"], so it should NOT be linked on macOS
+    assert!(
+        !target.join("configuration.nix").exists(),
+        "nixos package should be skipped on macOS",
+    );
+
+    // But macos-compatible packages should be linked
+    assert!(target.join(".gitconfig").exists());
+}
+
+#[test]
+fn test_fixture_link_and_unlink_round_trip() {
+    let tmp = TempDir::new().unwrap();
+    setup_from_fixture(&tmp);
+    let dotfiles = tmp.path().join("dotfiles");
+    let target = tmp.path().join("home");
+
+    // Link all
+    let (_, _, ok) = run(&dotfiles, &["link"]);
+    assert!(ok);
+    assert!(target.join(".gitconfig").exists());
+
+    // Unlink all
+    let (_, _, ok) = run(&dotfiles, &["unlink"]);
+    assert!(ok);
+    assert!(!target.join(".gitconfig").exists());
+    assert!(!target.join(".zshrc").exists());
+}
diff --git a/crates/notgraph/.DS_Store b/crates/notgraph/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..9126d76cbf1a14fcf5bc513861ef6dcc05717c35
GIT binary patch
literal 6148
zcmeHK%}T>S5T0!-v{a!-Pm(7P>d{jS@#d{BQ2T=l2`N_Zx#~gm8GH*7>`fm=-@$KY
zmUd%fZ;Hqa%zm5MnVrcOlF1U0ORgt<q8<^op^S|Vh8p2@)-`E(%Qn#Q9{s_%$Y*PQ
zX85}d@Uv^uoGxjcorTY@yj`v2MVgMXVgyV3>G0&ayLdecS0@`*XXoLr3xrXJu4qa*
z%_yT&na``acRuR9!a9b@!T#fm)KRlvUaV@`>{+dk-vipxnlOH;Ywx|f8rIXlyLh;H
zlX`;qu#S3<YW{o9Z(<A>1IEBlGk~7W((WqSXbczw#=w#R{ys!d#@J)2D4z}tas&Xj
zU>3n#{-J;o8-TILQV|x2(@>y>I)B7)8V-Bp{bG-$qK1=`%-F|gcK(FoBs=VpxRZ+&
zZ8Qdqfhq${z3g%SKmPvwUk$P=W55{rR}8pTI!F`TlJBi+H^;p;f)1f9>{lu-Lokt6
f3}0@=yHF9>Bc1?bkEJ3k5c?4j8f-8IewBew%#3O0

literal 0
HcmV?d00001

diff --git a/crates/nothooks/.DS_Store b/crates/nothooks/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..8f0b89cdf44887d86eeb29387c681f982bf70f96
GIT binary patch
literal 6148
zcmeHKy-ve05Wb^DieTx;=vSzCfl!4VsWTF4ivX!nDq420jBLCK6EnOEFTr<rrnN=H
zh!DM#?9aX*U-Cuq*+j&XhsBs^L_`&uAj_afMBQsTNX}wpSz|n%ckQZYiNC9oXCKg-
z?rFZf$)7)*?ksKBG_z$lgQj|ZxqEtie>=;qiyy43+kDjvgwY{w=o&dUv@UZVU6$57
z@5k#lZx-KnyWIUAWq$e2F3x~6;0!ned(HrAwn%ks=)E)G3^)T@24sH-Xo7XZXsBBU
zI=un_hfu3vtY=JM5CyPK7!9F;u!RCGl+zW1Egbrg{OW|!(87r|GuBC&zb-GFPPiP@
zowzpi-WhNPN(Kft9ZCH^$FJ0T$uC2E<_tIk|BL}1Hq&N;mrAwu+v`cK4QN+rBH|Zi
q0Kr&GF;Gh}CbEy5sL|{}#<153qoJ%KdJPBqK|l%d&KdXx20j5`E=Pd?

literal 0
HcmV?d00001

diff --git a/crates/notsecrets/.DS_Store b/crates/notsecrets/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..adeb7e4309a32d6054e60d23477eefc8adbeb555
GIT binary patch
literal 6148
zcmeHKy-LJD5T3m|@kE6y?c5iz$Q$I2h^>&;!ut^|F68t)u*_rF2)>D>;FE}zy^Y_@
zEcqc3tPYVG*!?!MGx;{(Zn9Y-a+A#>A{r6V5QVX~hpNN4pG(Vn!E*p~a*q`)>5A6N
z>nLqSo8vDkz;idmoITK#GOEqrJkM4-;NA1Cm@H3{*)pGT-`nQ>%e}mgyW<wWid)@8
zX~oIwk@~czJDT%qDtp}ew(6;m;duHqKKqa{guE=TnA^P#zTPwQ?a)21UevOJOHMk(
zn^Nzs^9~*_K2MalmS5-Yj%e_cXMQtNz!WeAwxs~}Y_{RPqSdB=DPRhe3h?*AqcFw+
z3q|>Kppqj1Z~(U$+VbxP^y~n}0SiTVU`|tkn(D$4!)ZGFKE%ZV3q?&QC(O7{V0Phz
z;)ET3FX7~3MXOB#Q=q9pUoS_z|DXPR{%<DPl__8f{3`|AAW4%69x3dtt%u{i)}vga
puyI_WSf-#MTQOpJD?UOIgWq!l7zZpA;epwYfXHB#DX>)qz5yP7X-@zE

literal 0
HcmV?d00001

diff --git a/crates/notsecrets/Cargo.toml b/crates/notsecrets/Cargo.toml
index 9c1abbf..eb216fa 100644
--- a/crates/notsecrets/Cargo.toml
+++ b/crates/notsecrets/Cargo.toml
@@ -14,7 +14,6 @@ serde            = { workspace = true }
 toml             = { workspace = true }
 x25519-dalek     = { version = "2", features = ["static_secrets"] }
 ed25519-dalek    = "2"
-rsa              = { version = "0.9", features = ["sha2"] }
 sha2             = "0.10"
 hkdf             = "0.12"
 chacha20poly1305 = "0.10"
diff --git a/crates/notsecrets/src/identities/mod.rs b/crates/notsecrets/src/identities/mod.rs
index dccc174..a9e2ddd 100644
--- a/crates/notsecrets/src/identities/mod.rs
+++ b/crates/notsecrets/src/identities/mod.rs
@@ -9,9 +9,6 @@ pub use ssh_ed25519::SshEd25519Identity;
 pub mod scrypt;
 pub use scrypt::ScryptIdentity;
 
-pub mod ssh_rsa;
-pub use ssh_rsa::SshRsaIdentity;
-
 pub mod encrypted;
 pub use encrypted::EncryptedIdentity;
 
diff --git a/crates/notsecrets/src/identities/ssh_rsa.rs b/crates/notsecrets/src/identities/ssh_rsa.rs
deleted file mode 100644
index c13fe80..0000000
--- a/crates/notsecrets/src/identities/ssh_rsa.rs
+++ /dev/null
@@ -1,110 +0,0 @@
-use crate::error::AgeError;
-use crate::identities::{FileKey, Identity, Stanza};
-use base64::{Engine, engine::general_purpose::STANDARD_NO_PAD};
-use rsa::{Oaep, RsaPrivateKey, RsaPublicKey, traits::PublicKeyParts};
-use sha2::{Digest, Sha256};
-
-const TAG: &str = "ssh-rsa";
-
-pub struct SshRsaIdentity {
-    private_key: RsaPrivateKey,
-}
-
-impl SshRsaIdentity {
-    pub fn from_private_key(private_key: RsaPrivateKey) -> Self {
-        Self { private_key }
-    }
-
-    fn fingerprint(&self) -> [u8; 4] {
-        rsa_pubkey_fingerprint(&RsaPublicKey::from(&self.private_key))
-    }
-}
-
-impl Identity for SshRsaIdentity {
-    fn unwrap_file_key(&self, stanza: &Stanza) -> Option<Result<FileKey, AgeError>> {
-        if stanza.tag != TAG {
-            return None;
-        }
-        if stanza.args.len() != 1 {
-            return Some(Err(AgeError::ParseError(
-                "ssh-rsa stanza must have 1 arg".to_string(),
-            )));
-        }
-        let fp = match STANDARD_NO_PAD.decode(&stanza.args[0]) {
-            Ok(b) => b,
-            Err(e) => {
-                return Some(Err(AgeError::ParseError(format!(
-                    "fingerprint base64: {e}"
-                ))));
-            }
-        };
-        if fp.as_slice() != self.fingerprint() {
-            return None;
-        }
-        Some(unwrap(stanza, &self.private_key))
-    }
-}
-
-fn unwrap(stanza: &Stanza, private_key: &RsaPrivateKey) -> Result<FileKey, AgeError> {
-    let padding = Oaep::new::<Sha256>();
-    let file_key_bytes = private_key
-        .decrypt(padding, &stanza.body)
-        .map_err(|_| AgeError::CryptoError("RSA-OAEP decrypt failed".to_string()))?;
-    FileKey::try_from(file_key_bytes.as_slice())
-}
-
-pub(crate) fn rsa_pubkey_fingerprint(public_key: &RsaPublicKey) -> [u8; 4] {
-    let n_bytes = public_key.n().to_bytes_be();
-    let e_bytes = public_key.e().to_bytes_be();
-    let mut hasher = Sha256::new();
-    hasher.update(&n_bytes);
-    hasher.update(&e_bytes);
-    let hash = hasher.finalize();
-    hash[..4].try_into().expect("SHA-256 is 32 bytes")
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-    use crate::recipients::Recipient;
-    use crate::recipients::ssh_rsa::SshRsaRecipient;
-    use rand::rngs::OsRng;
-
-    fn test_rsa_keypair() -> (RsaPrivateKey, RsaPublicKey) {
-        let private_key = RsaPrivateKey::new(&mut OsRng, 2048).expect("RSA keygen failed");
-        let public_key = RsaPublicKey::from(&private_key);
-        (private_key, public_key)
-    }
-
-    #[test]
-    fn ssh_rsa_wrap_unwrap_roundtrip() {
-        let (private_key, public_key) = test_rsa_keypair();
-        let recipient = SshRsaRecipient::from_public_key(public_key);
-        let identity = SshRsaIdentity::from_private_key(private_key);
-
-        let file_key = FileKey::new([0x55u8; 16]);
-        let stanza = recipient
-            .wrap_file_key(&file_key)
-            .expect("wrap should succeed");
-        assert_eq!(stanza.tag, "ssh-rsa");
-        assert_eq!(stanza.args.len(), 1);
-
-        let unwrapped = identity
-            .unwrap_file_key(&stanza)
-            .expect("identity should match")
-            .expect("unwrap should succeed");
-        assert_eq!(unwrapped.as_bytes(), file_key.as_bytes());
-    }
-
-    #[test]
-    fn ssh_rsa_wrong_fingerprint_returns_none() {
-        let (private_key1, _) = test_rsa_keypair();
-        let (_, public_key2) = test_rsa_keypair();
-        let recipient = SshRsaRecipient::from_public_key(public_key2);
-        let identity = SshRsaIdentity::from_private_key(private_key1);
-
-        let file_key = FileKey::new([0x55u8; 16]);
-        let stanza = recipient.wrap_file_key(&file_key).unwrap();
-        assert!(identity.unwrap_file_key(&stanza).is_none());
-    }
-}
diff --git a/crates/notsecrets/src/lib.rs b/crates/notsecrets/src/lib.rs
index 2fe288e..831dfc6 100644
--- a/crates/notsecrets/src/lib.rs
+++ b/crates/notsecrets/src/lib.rs
@@ -15,13 +15,11 @@ pub use encrypt::Encryptor;
 pub use error::AgeError;
 pub use error::SecretsError;
 pub use identities::{
-    EncryptedIdentity, FileKey, Header, Identity, ScryptIdentity, SshEd25519Identity,
-    SshRsaIdentity, Stanza, X25519Identity,
+    EncryptedIdentity, FileKey, Header, Identity, ScryptIdentity, SshEd25519Identity, Stanza,
+    X25519Identity,
 };
 pub use ports::{EnumerableSecretSource, IdentitySource, SecretSource};
-pub use recipients::{
-    Recipient, ScryptRecipient, SshEd25519Recipient, SshRsaRecipient, X25519Recipient,
-};
+pub use recipients::{Recipient, ScryptRecipient, SshEd25519Recipient, X25519Recipient};
 pub use resolver::SecretResolver;
 pub use sources::{
     BitwardenSource, DirenvSource, DotenvxSource, DotenvySource, EnvSource, FileSource, GsmSource,
diff --git a/crates/notsecrets/src/recipients/mod.rs b/crates/notsecrets/src/recipients/mod.rs
index 1c1ed1d..8d0389b 100644
--- a/crates/notsecrets/src/recipients/mod.rs
+++ b/crates/notsecrets/src/recipients/mod.rs
@@ -10,9 +10,6 @@ pub use ssh_ed25519::SshEd25519Recipient;
 pub mod scrypt;
 pub use scrypt::ScryptRecipient;
 
-pub mod ssh_rsa;
-pub use ssh_rsa::SshRsaRecipient;
-
 /// Domain port: a recipient that can wrap a file key into a stanza.
 pub trait Recipient {
     fn wrap_file_key(&self, file_key: &FileKey) -> Result<Stanza, AgeError>;
diff --git a/crates/notsecrets/src/recipients/ssh_rsa.rs b/crates/notsecrets/src/recipients/ssh_rsa.rs
deleted file mode 100644
index c308aaf..0000000
--- a/crates/notsecrets/src/recipients/ssh_rsa.rs
+++ /dev/null
@@ -1,38 +0,0 @@
-use crate::error::AgeError;
-use crate::identities::ssh_rsa::rsa_pubkey_fingerprint;
-use crate::identities::{FileKey, Stanza};
-use crate::recipients::Recipient;
-use base64::{Engine, engine::general_purpose::STANDARD_NO_PAD};
-use rsa::{Oaep, RsaPublicKey};
-use sha2::Sha256;
-
-const TAG: &str = "ssh-rsa";
-
-pub struct SshRsaRecipient {
-    public_key: RsaPublicKey,
-}
-
-impl SshRsaRecipient {
-    pub fn from_public_key(public_key: RsaPublicKey) -> Self {
-        Self { public_key }
-    }
-}
-
-impl Recipient for SshRsaRecipient {
-    fn wrap_file_key(&self, file_key: &FileKey) -> Result<Stanza, AgeError> {
-        use rand::rngs::OsRng;
-        let padding = Oaep::new::<Sha256>();
-        let wrapped = self
-            .public_key
-            .encrypt(&mut OsRng, padding, file_key.as_bytes())
-            .map_err(|_| AgeError::CryptoError("RSA-OAEP encrypt failed".to_string()))?;
-
-        let fingerprint = rsa_pubkey_fingerprint(&self.public_key);
-
-        Ok(Stanza {
-            tag: TAG.to_string(),
-            args: vec![STANDARD_NO_PAD.encode(fingerprint)],
-            body: wrapped,
-        })
-    }
-}
diff --git a/docs/superpowers/.DS_Store b/docs/superpowers/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..50d1617cffa9bd79e7badfe2510ac59bcb42aae0
GIT binary patch
literal 6148
zcmeHKJx;?=4EAe^lnRD!AhEn1b?C+zs&Il{0NSE5BqUPBo`D;12{;5Z5=ZF7%qjT%
zY(igC#D);qlHd2@pE&sv#W4}N$?alHG$f)F%GeuV*&*y_?MP28>~!HAt718x&a1NS
z#G2uEGQiJnk7_FDl5Qw|e#y&0>@BN2pB2>%*7RZhbU1o@KHH91d=pV$Z@eMNE7DPa
zg)6wC`Br^;ypO$`_1CAzcPAh9+x)WntiL-Vs!yRlUxSG;U<?=o|A_(gY?gFi&{ku>
z7%&D}2Kf8np^TYgBN#p%Si%SZ?86)cd!8jY$17%vjUYS_C#gV5bvj}=Nr&BQT&CCv
zN;)|mKAcu|I-$5w9q0EUoLnYot1(~<#0(^IIOP6+{`LGHC)trPU<~{z23$X%<`dkK
y_SVkLaj*5z3n&Z6HG*vlHlY<GmRs==GzjdTH^5A>5rhR|KLUXUTa1ApW#AoKZcE?*

literal 0
HcmV?d00001

diff --git a/notfiles.toml b/notfiles.toml
new file mode 100644
index 0000000..194fdc1
--- /dev/null
+++ b/notfiles.toml
@@ -0,0 +1,7 @@
+[defaults]
+target = "~"
+ignore = [".git", ".DS_Store", "README.md", "LICENSE*", "notfiles.toml", ".notfiles-state.toml", ".nothooks-state.toml", "Cargo.toml", "Cargo.lock", "crates", "docs", "tests", "target", "scripts", "mise.toml", "deny.toml", "rustqual.toml", ".github", ".gitea", ".envrc", ".sccignore", ".codex", ".superpowers", ".remember", ".worktrees", ".ctx", "HANDOFF.md", "AGENTS.md", "preflight.md"]
+
+include = ["nushell"]
+
+[packages.nushell]
diff --git a/nushell/.DS_Store b/nushell/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..8a9b3a7243799330581385b47370c47417d1712f
GIT binary patch
literal 8196
zcmeHMTWl0n7(U;$&>1?=DHIr_g@vj_Y@jVrC<t!bMeekAd!t<1-JPKwna-4**)3Wd
z8x!LNFVQFCE&8O<NYr>C`eLGj8ZU{U24j3cP1M9_qAw;U_@6nm1Y4RILk#MiWX^xi
ze>rE)Ki@ZJ&n#mM%{ilvF`Y3c)5WD$O4UUQxASXKkwOhOg5nuF$SgLH9`T0L_9X8}
z5oI9CK$L+f15pN|3|tNwpgo%xd5V2sSfe`1K$L<1Wd`{BAx0OM@lcKn8N52E3XT9I
zi%A_6YSTF&h>3+V9?EecgHRe%oE{K{B0OS1gp)nS-ATqnIWD9KXAt2G;min6C<tb!
zxLDxM5EnA4qYOkDn4AGln-aEyWthvH3(xOvnk>iD!?xx5wY8r?Dk`2fy+kgNOXdB^
zL3bqSr~I7PoXYOyy$;v4(}i{_-DR00eOg6}>-Z_lF|$E{Wtil$uiJ7Accj_PIffU+
zCWS#(WTj8jM@Q=$8){;!8XL!IVxx`qwKcKTs~X0}6nSp-$_?#(hwLH8y+<qr;md%{
zoUpK?lUHRA)Fm_S(6I3Q_+lPjz9nt*br-EEtow_?x|JEF>P)qxv#YyD?bBxGX@RZ7
zzU4YzmzniQ_Gx7vC1P8~b=tBfw|8e;J2&KbeOh@YWoL4B$~T*AJ89iwlCI3lWL?{C
zb3Ka>v!};5kNDg+$<)*9xmmv@7_7&l@r9R`^UQXW2DS2Lf`;}gCL{sMv03vgmt3`c
z<?6<b%{Oe{eY#95pFO8SReLGpj&B{b%xvd~W%z@8QeMV%49gkl&Rd?9w#^PFHDs2f
zMo~`B*2>HD1^Pl+tCo9mY3p##@^22ts#>J0`wW_Umuv9R4DA(J2`oz&>H1!7X~~*Y
z8?qdzuU@9B9Ud)GONEZt)~IU7A%cYF(Nz2fYwJ|K(@v#LTQd|9wx&VVyYnK?+Ky1U
zzCzV|=!p)|QoK;N>3Us1z^C1r^8D6e)1g~>H=MhLY`xxKDr>fm5F|tG7SaZfj`Tce
zvtjuzHwLR-r0<gDJ$%3>!!V8D{#x63gl0K;izq;kPB20HM3$B6!Xv1TFBi?~H*b0}
zXaxzaj@JscLfc&xt7i$ell8MK8)f&ghuKr?W%dp`!9HbQvG3VW>^A_@p<o6|QGvOb
z4;@Re9Ba{t_1J&}+HfP<u^0VFBLf3N$ihbsdEACOa3}7<-FOI(;4wUoC-5|0z>9bZ
zZ{U4=fDiEzKF3*njc@QH&PhyyG(#$tRB4{HSgMy+OKYSCX{{8Own^<$x706gT`G{S
zSM&?Dl%m#zSBdTA=~E!5lyqzgN^RM?ZTpUY52en`5+s^CZ+?t3Yu(1C^B@$cEdcdG
z_y?H(6H@}r2bh?E*VFofD;8E(sf!CtoXF5lB8z!M=G@dug!fYQN}0%_O%vT^>NPUa
zM4K+UHI*x5BBmw<UA3-ql|uB>ibS`ja;+k35S{hvbqWztD;C`<HLfTc3p$l8m78TE
zlXl5aeukZ8-?5+B?}YMMm_yiJhFYw{CTzuSv=Xk9=)?i^Aw}rs*mf|C!|-q`#t7fz
zxE)7vFYd<!c#tsuD50EV{24rp=kPpU#cMc@*YOtK#tEFndxZK^_!8gZ2mCSt%ex9F
z781Ws#`2JxNC+%5xvlHe=>Bsjn=a;M`~|P!!3#DcwDCzNFejhPI=1T!kfp#k?sZ8^
zkr++q=l{)9fB(Ovb4G(j8Hh4)d1U~_iDaUg?rEwwjYPH>UHx?N!u`gD3__^lE?gfR
o$4Q?5!;sps&=wEnxR7L_@{fNA;6K^^{!i*?|Bv?n|HS_P2SU!H*Z=?k

literal 0
HcmV?d00001

diff --git a/nushell/.config/.DS_Store b/nushell/.config/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..b65668a2ea5c52b29aebae688685e17e45939bb3
GIT binary patch
literal 8196
zcmeHMTWl0n7(U;$(3y6m(^6oNEi6<eVxuimZVGPOt=ws)EiFZ9cXviQIy<xM%x=MJ
zLt@Z)i#{1|(I<^Yyu@4d#Y6=)>Vsko#`u7msEN@;UrbE!Kj%ydwlw%)jD$JKIsZBT
z?VSDR`{(4JWsIStWVJG8GR9QuoEkMWoS|_!?^Bu*ajJ-d>>0C}%UpMFYj4h<q8&5h
z2*eSHBM?U*jzAoN|3d`m&gM;>=H8dmc#I<uN8r4S0DnIusdJi&=(wcf)j@+O0f<%-
zTQr(e9UyFy5luyOTvB05K4tZQ$P`hD0clS1Bv&Vzis-nc(wsq>GekQhs!$+yC%dFj
zXGlpJk8uRz2uzItuidMd$4V?<qo>#J`GQn_@z5DGf^uip^|Opsv}Fsf6ND`-UqPv;
zoH4UX)v9as3-rGJodbjVuu)%j?6K}b==ff+(=G-?hmG1`)F0cF^Sz#;&E*3*-!0|6
zVA!b3W!zlJ&4hNl>-IXg*u<+1az)>Dd;GxRZgvfZ_WqE|riccI0>2n`3TJ~3`IlNo
zDX@3g<kTtKX>uJjOo{`v!?Wfk7GJ#ViWO_tbzHl7`>|T1u6}ldt`9ku?S;;bj$P~@
zbF6T5S0>2Wp5=IZ2g*+1WL>+@%jE4kG;7+idZVt^oNq2rjV5)lly&x%obZ6~)ws~q
zueWILZNA05S;lLsCL~K1n&xgU=`7kbTB<78mn=2)zJPwDk%<&9Yu5F?n;p+G0@{in
zu%%Tu``t{|b`49DW^F5VbD%8aY;1{`Ya4WPFz4s<^izU}xBeQ_+{3rsnhC=0g6+|f
zK8W`2B-v0fnkm}dW1d}%xEqKo9v$(yQJ3X}J{O8#z0lmIs=K(ucFVFYalY;zZeciH
z*$FB5^f-u=0^>7P)tV+AK~rj(oHo64(^Fz50@{>nk!+1FhDNrWrP)?C!iwxxc0YTB
zJ<VQa@3SN93-%5Bk^RE{05B68s!@Xm%)vaESd3*@g*8}<tB^(yuEP%O#t5>=!9pHI
zgeakmJ8>5d;cnc6hw&&L#}jxG&)_Azj92hBKElWN1fSwdoWQsE4nO0h!W1agN{yl`
zbCpHPa%F|mrmR#}DJf->vO^hAM&!|z=&oWzay>CB8JbN_x}aQ;DWx2qCZ#rP+_ZVi
zxsy`IXUQa*Gk0E+XV&U<?WaH}Q9A+D)8Q{L|F=vLm=~Csgx6!{{0kQ(8udjJnK(H^
z`zcxM{VLB*qe^No(JxXdS&SKSxm3SYr8F^S%4Kuna+MO(P{dMiO<bu_`WY2+*_>FV
zsRra?t$wveiD*>HWuu<bG=qsnqBGH@QZgC;8p@Be6YK}}EBljBJ`1x6+e^`c)mV>>
z*p6<(buap{2gAq^x;eHz6tE8gZo}<_?{OT&y|@n#;6Xe@7=MgV&N2Qhp2PEa0k7i?
zyotB)F5bft9L0x(`p@w-zQ<4aZ4#EZO`up({5}=Sc|V<&SZ3<#1ATYgaPnyTnY65b
zpj8;<ACsfY2uX4?IdjUrMbGuUy(F2)H?9@8vqqpoYM8wK@0$Mm|5^RS3ULJD2%NhS
zKxMi&-9hJ{?)}MY?IiUP>b!BiaY=;<4Wb+;D#~%9r~WXcd6HDQO)8?}k`jm7fBqpL
OzW?L<Um)-N9{vJPgejK*

literal 0
HcmV?d00001

diff --git a/nushell/.config/nushell/.DS_Store b/nushell/.config/nushell/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..80e66bce2657058609d151d0ed4b9a48526c8080
GIT binary patch
literal 6148
zcmeHKJ5B>J5S@X5R-#Es=_}+0CNd{TNdudeNU@P4h4kha+=h-@A>McflvP|H3WU&%
zWWTZJWBW;K?+_6$55t0JPDCA=AdAuvnQofS%=rSyHOEMq9%vZ$>#>pOFHXtcJM8&D
zPuTm>{`;Iq9O~3KJ}y@4yxr+(HqR}eZBD5lb1$}+ba_|a-)`D|!?*l)o8vWKk;=sx
za0Z+KXTTZwDFgDnLAonN@0|f>z!~^rK<<ZtCKwHiV!b-h)e-<W!*mtsQcFloFpP#p
z5f%t*C{RP$N(|O;%m?#}hDA}siLLlxTluqi;kr8Vhw4ro6}@)`oPj9==Q^Cr`+tj1
zrdi}qLww{6I0OHT0iLB*TH;Xlww@eM-r9h6k0v61MHC41$xi?Va*teBquPV$@Qa2;
VQL@N<4F~#<KqbUGXW$nY_y8IFH&6fo

literal 0
HcmV?d00001

diff --git a/rustqual.toml b/rustqual.toml
new file mode 100644
index 0000000..fc69dbd
--- /dev/null
+++ b/rustqual.toml
@@ -0,0 +1,99 @@
+# rustqual.toml — Tailored configuration for your project
+# Generated from analysis of 87 file(s), 488 function(s).
+#
+# Thresholds are set to your current maximums + 20% headroom.
+# Tighten them over time as you improve code quality.
+
+# ── Function Classification ──────────────────────────────────────────────
+
+ignore_functions = ["main", "test_*"]
+exclude_files = [
+    "crates/notgraph/tests/*",
+    "scripts/preflight.rs",
+]
+strict_closures = false
+strict_iterator_chains = false
+allow_recursion = false
+strict_error_propagation = false
+
+# ── Suppression Health ───────────────────────────────────────────────────
+
+max_suppression_ratio = 0.05
+fail_on_warnings = false
+
+# ── Complexity Analysis ──────────────────────────────────────────────────
+
+[complexity]
+enabled = true
+max_cognitive = 72           # current max: 60
+max_cyclomatic = 30          # current max: 25
+max_nesting_depth = 9            # current max: 7
+max_function_lines = 286         # current max: 238
+include_nesting_penalty = true
+detect_magic_numbers = true
+detect_unsafe = true
+detect_error_handling = true
+allowed_magic_numbers = ["0", "1", "-1", "2"]
+
+# ── DRY / Duplicate Detection ───────────────────────────────────────────
+
+[duplicates]
+enabled = true
+similarity_threshold = 0.85
+min_tokens = 30
+min_lines = 5
+min_statements = 3
+ignore_tests = true
+ignore_trait_impls = true
+detect_dead_code = false
+detect_wildcard_imports = true
+detect_repeated_matches = true
+
+# ── Boilerplate Detection ───────────────────────────────────────────────
+
+[boilerplate]
+enabled = true
+suggest_crates = true
+
+# ── SRP (Single Responsibility) ─────────────────────────────────────────
+
+[srp]
+enabled = true
+smell_threshold = 0.6
+max_fields = 12
+max_methods = 20
+max_fan_out = 10
+lcom4_threshold = 2
+weights = [0.4, 0.25, 0.15, 0.2]
+file_length_baseline = 300
+file_length_ceiling = 800
+max_independent_clusters = 2
+min_cluster_statements = 5
+max_parameters = 5
+
+# ── Coupling Analysis ───────────────────────────────────────────────────
+
+[coupling]
+enabled = true
+max_instability = 0.8
+max_fan_in = 15
+max_fan_out = 12
+check_sdp = true
+
+# ── Test Quality Analysis ──────────────────────────────────────────────
+
+[test_quality]
+enabled = true
+# coverage_file = "lcov.info"
+
+# ── Quality Score Weights ──────────────────────────────────────────────
+# Must sum to approximately 1.0.
+
+[weights]
+iosp         = 0.22
+complexity   = 0.18
+dry          = 0.13
+srp          = 0.18
+coupling     = 0.09
+test_quality = 0.10
+architecture = 0.10
diff --git a/tests/integration/tests/cross_crate.rs b/tests/integration/tests/cross_crate.rs
index 1b768f5..c12af19 100644
--- a/tests/integration/tests/cross_crate.rs
+++ b/tests/integration/tests/cross_crate.rs
@@ -66,6 +66,133 @@ fn secret_resolver_resolves_env_var_cross_crate() {
     unsafe { std::env::remove_var("NOTFILES_CROSS_CRATE_TEST") };
 }
 
+// ── nu_libs nushell package e2e ───────────────────────────────────────────────
+
+/// Helper: build a dotfiles dir containing the nushell/nu_libs.nu package
+/// mirroring the real notfiles repo layout.
+fn make_nu_libs_dotfiles(dotfiles: &Path, target_home: &Path) {
+    let src = dotfiles.join("nushell/.config/nushell/autoload");
+    fs::create_dir_all(&src).unwrap();
+    fs::write(
+        src.join("nu_libs.nu"),
+        b"const NU_LIBS_AI = \"/Users/joe/dev/nu_libs/lib/ai/mod.nu\"\nuse $NU_LIBS_AI *\n",
+    )
+    .unwrap();
+    fs::write(
+        dotfiles.join("notfiles.toml"),
+        format!(
+            "[defaults]\ntarget = \"{}\"\ninclude = [\"nushell\"]\n\n[packages.nushell]\n",
+            target_home.display()
+        )
+        .as_bytes(),
+    )
+    .unwrap();
+}
+
+/// The nu_libs autoload file is symlinked into the correct autoload directory.
+#[test]
+fn nu_libs_autoload_is_linked_to_target() {
+    let dotfiles = TempDir::new().unwrap();
+    let home = TempDir::new().unwrap();
+    let autoload = home.path().join(".config/nushell/autoload");
+    fs::create_dir_all(&autoload).unwrap();
+
+    make_nu_libs_dotfiles(dotfiles.path(), home.path());
+
+    let opts = LinkOptions {
+        force: false,
+        no_backup: false,
+        dry_run: false,
+        verbose: false,
+    };
+    link(dotfiles.path(), &["nushell".to_string()], &opts).unwrap();
+
+    let link_path = autoload.join("nu_libs.nu");
+    assert!(link_path.exists(), "nu_libs.nu should exist at target");
+    assert!(link_path.is_symlink(), "nu_libs.nu should be a symlink");
+    assert_eq!(
+        fs::read_link(&link_path).unwrap(),
+        dotfiles
+            .path()
+            .join("nushell/.config/nushell/autoload/nu_libs.nu"),
+        "symlink should point into the notfiles nushell package"
+    );
+}
+
+/// Unlinking removes the symlink but leaves the autoload directory intact.
+#[test]
+fn nu_libs_autoload_is_removed_on_unlink() {
+    let dotfiles = TempDir::new().unwrap();
+    let home = TempDir::new().unwrap();
+    let autoload = home.path().join(".config/nushell/autoload");
+    fs::create_dir_all(&autoload).unwrap();
+
+    make_nu_libs_dotfiles(dotfiles.path(), home.path());
+
+    let opts = LinkOptions {
+        force: false,
+        no_backup: false,
+        dry_run: false,
+        verbose: false,
+    };
+    link(dotfiles.path(), &["nushell".to_string()], &opts).unwrap();
+    notfiles::unlink(dotfiles.path(), &["nushell".to_string()], &opts).unwrap();
+
+    assert!(
+        !autoload.join("nu_libs.nu").exists(),
+        "symlink should be removed after unlink"
+    );
+}
+
+/// A pre-existing regular file at the target path causes link to fail without --force.
+#[test]
+fn nu_libs_link_does_not_overwrite_existing_file_without_force() {
+    let dotfiles = TempDir::new().unwrap();
+    let home = TempDir::new().unwrap();
+    let autoload = home.path().join(".config/nushell/autoload");
+    fs::create_dir_all(&autoload).unwrap();
+    fs::write(autoload.join("nu_libs.nu"), b"# existing\n").unwrap();
+
+    make_nu_libs_dotfiles(dotfiles.path(), home.path());
+
+    let opts = LinkOptions {
+        force: false,
+        no_backup: false,
+        dry_run: false,
+        verbose: false,
+    };
+    let result = link(dotfiles.path(), &["nushell".to_string()], &opts);
+    assert!(
+        result.is_err(),
+        "link should fail when target file exists without --force"
+    );
+}
+
+/// With --force the existing file is replaced by a symlink.
+#[test]
+fn nu_libs_link_with_force_replaces_existing_file() {
+    let dotfiles = TempDir::new().unwrap();
+    let home = TempDir::new().unwrap();
+    let autoload = home.path().join(".config/nushell/autoload");
+    fs::create_dir_all(&autoload).unwrap();
+    fs::write(autoload.join("nu_libs.nu"), b"# existing\n").unwrap();
+
+    make_nu_libs_dotfiles(dotfiles.path(), home.path());
+
+    let opts = LinkOptions {
+        force: true,
+        no_backup: false,
+        dry_run: false,
+        verbose: false,
+    };
+    link(dotfiles.path(), &["nushell".to_string()], &opts).unwrap();
+
+    assert!(
+        autoload.join("nu_libs.nu").is_symlink(),
+        "nu_libs.nu should be a symlink after forced link"
+    );
+}
+
 /// Test that notfiles ignores .notfiles-state.toml and .nothooks-state.toml
 /// by default — they must not be symlinked into the target directory and must
 /// not appear in the returned State.