fix: harden CLI correctness and anchor handling

.claude/skills/drift/SKILL.md

@@ -3,10 +3,10 @@ name: drift
 description: Drift spec-to-code anchor conventions. Use when editing code that is bound by drift specs, updating specs, working with drift frontmatter, or when drift check reports stale anchors.
 drift:
   files:
-    - src/main.zig@d7d189a
-    - src/frontmatter.zig@d7d189a
-    - src/scanner.zig@d7d189a
-    - src/vcs.zig@d7d189a
+    - src/main.zig@a7ffa398
+    - src/frontmatter.zig@a7ffa398
+    - src/scanner.zig@a7ffa398
+    - src/vcs.zig@a7ffa398
 ---
 
 # Drift

README.md

@@ -84,9 +84,9 @@ If you don't want frontmatter visible on GitHub, use an HTML comment instead:
 
 ```
 drift check         Check all specs for staleness (exits 1 if stale)
-drift status        Show all specs and their anchors
+drift status        Show all spec anchors, including inline @./ refs
 drift link          Add an anchor to a spec (auto-appends provenance)
-drift unlink        Remove an anchor from a spec
+drift unlink        Remove an anchor from frontmatter or drift comments
 ```
 
 `drift lint` is an alias for `drift check`.

docs/CLI.md

@@ -1,12 +1,12 @@
 ---
 drift:
   files:
-    - src/main.zig@d7d189a
+    - src/main.zig@a7ffa398
 ---
 
 # CLI Reference
 
-All commands support `--format json` for tool integration.
+`drift status` supports `--format json` for tool integration. Usage and command errors exit non-zero.
 
 ## drift lint
 
@@ -39,7 +39,7 @@ docs/project.md
 
 ## drift status
 
-Show all specs and their anchors without checking staleness.
+Show all specs and their anchors without checking staleness. This includes explicit frontmatter anchors, `<!-- drift: ... -->` comment anchors, and inline `@./path` references from the spec body.
 
 ```
 drift status [--format json]
@@ -87,7 +87,7 @@ If the spec file doesn't have `drift:` frontmatter yet, it's added. If the file
 
 ## drift unlink
 
-Remove an anchor from a spec's frontmatter.
+Remove an anchor from a spec's YAML frontmatter or `<!-- drift: ... -->` comment block.
 
 ```
 drift unlink <spec-path> <file>

docs/DECISIONS.md

@@ -1,9 +1,9 @@
 ---
 drift:
   files:
-    - src/main.zig@d7d189a
-    - src/symbols.zig@d7d189a
-    - src/vcs.zig@d7d189a
+    - src/main.zig@a7ffa398
+    - src/symbols.zig@a7ffa398
+    - src/vcs.zig@a7ffa398
 ---
 
 # Decisions

docs/DESIGN.md

@@ -1,11 +1,11 @@
 ---
 drift:
   files:
-    - src/main.zig@d7d189a
-    - src/frontmatter.zig@d7d189a
-    - src/scanner.zig@d7d189a
-    - src/symbols.zig@d7d189a
-    - src/vcs.zig@d7d189a
+    - src/main.zig@a7ffa398
+    - src/frontmatter.zig@a7ffa398
+    - src/scanner.zig@a7ffa398
+    - src/symbols.zig@a7ffa398
+    - src/vcs.zig@a7ffa398
 ---
 
 # Design