etymd 0.19.0 → 0.19.2

package/dist/index.js

@@ -20,7 +20,7 @@ var __export = (target, all) => {
 var PACK_VERSION;
 var init_version = __esm({
   "src/pack/version.ts"() {
-    PACK_VERSION = "14";
+    PACK_VERSION = "16";
   }
 });
 
@@ -30,7 +30,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "etymd",
-      version: "0.19.0",
+      version: "0.19.2",
       description: "Keep your agent instructions true \u2014 verify AGENTS.md, CLAUDE.md, rules, skills, and the task you hand an agent against the actual repo, with drift caught over time and a regression ledger.",
       keywords: [
         "cli",
@@ -501,23 +501,40 @@ async function detectArtifacts(root) {
   });
   return artifacts;
 }
+function withoutFencedCode(text) {
+  const kept = [];
+  let fence = null;
+  for (const line of text.split("\n")) {
+    if (fence === null) {
+      const open = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+      if (open?.[1] && !(open[1][0] === "`" && open[2]?.includes("`"))) fence = open[1];
+      else kept.push(line);
+    } else {
+      const close = /^ {0,3}(`{3,}|~{3,})[ \t]*$/.exec(line)?.[1];
+      if (close && close[0] === fence[0] && close.length >= fence.length) fence = null;
+    }
+  }
+  return kept.join("\n");
+}
 function detectClaudeCodeVersion() {
   const override = process.env.ETYMD_CLAUDE_VERSION;
   if (override !== void 0) {
     return Promise.resolve(override === "none" || override === "" ? null : override);
   }
-  claudeVersionMemo ??= pExecFile2("claude", ["--version"], { timeout: 5e3 }).then(({ stdout }) => /(\d+\.\d+\.\d+)/.exec(stdout)?.[1] ?? null).catch(() => null);
+  claudeVersionMemo ??= pExecFile2("claude", ["--version"], { timeout: 5e3 }).then(({ stdout }) => /(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)(?=\s|$)/.exec(stdout)?.[1] ?? null).catch(() => null);
   return claudeVersionMemo;
 }
-function versionBefore(a, b) {
-  const pa = a.split(".").map(Number);
-  const pb = b.split(".").map(Number);
-  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
-    const x = pa[i] ?? 0;
-    const y = pb[i] ?? 0;
+function mayPredate(a, b) {
+  const parse = (v) => /^(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?$/.exec(v.trim());
+  const pa = parse(a);
+  const pb = parse(b);
+  if (!pa || !pb) return true;
+  for (let i = 1; i <= 3; i++) {
+    const x = Number(pa[i]);
+    const y = Number(pb[i]);
     if (x !== y) return x < y;
   }
-  return false;
+  return pa[4] !== void 0 && pb[4] === void 0;
 }
 async function checkClaudePointer(root, claudeVersion) {
   const agentsAbs = path2.join(root, "AGENTS.md");
@@ -535,11 +552,11 @@ async function checkClaudePointer(root, claudeVersion) {
     return { ok: true, via: "same-file" };
   }
   const rootClaude = await readText(claudeAbs);
-  if (rootClaude !== null && ROOT_POINTER_IMPORT_RE.test(rootClaude)) {
+  if (rootClaude !== null && ROOT_POINTER_IMPORT_RE.test(withoutFencedCode(rootClaude))) {
     return { ok: true, via: "root-import" };
   }
   const dotClaude = await readText(path2.join(root, ".claude", "CLAUDE.md"));
-  if (dotClaude !== null && DOT_CLAUDE_IMPORT_RE.test(dotClaude)) {
+  if (dotClaude !== null && DOT_CLAUDE_IMPORT_RE.test(withoutFencedCode(dotClaude))) {
     return { ok: true, via: "dotclaude-import" };
   }
   if (rootClaude !== null || dotClaude !== null) {
@@ -550,7 +567,7 @@ async function checkClaudePointer(root, claudeVersion) {
     };
   }
   const version = await detectClaudeCodeVersion() ;
-  if (version !== null && versionBefore(version, CLAUDE_AGENTS_FALLBACK_VERSION)) {
+  if (version !== null && mayPredate(version, CLAUDE_AGENTS_FALLBACK_VERSION)) {
     return {
       ok: false,
       kind: "old-reader",
@@ -779,8 +796,8 @@ var init_detect = __esm({
     ];
     SHELL_SHEBANG = /^#!\s*\/\S*\b(?:ba|da|z)?sh\b|^#!\s*\/usr\/bin\/env\s+(?:ba|da|z)?sh\b/;
     SHELL_EXT = /\.(?:sh|bash|zsh)$/;
-    ROOT_POINTER_IMPORT_RE = /^\s*@(\.\/)?AGENTS\.md\s*$/m;
-    DOT_CLAUDE_IMPORT_RE = /^\s*@\.\.\/AGENTS\.md\s*$/m;
+    ROOT_POINTER_IMPORT_RE = /^ {0,3}@(\.\/)?AGENTS\.md[ \t]*$/m;
+    DOT_CLAUDE_IMPORT_RE = /^ {0,3}@\.\.\/AGENTS\.md[ \t]*$/m;
     CLAUDE_AGENTS_FALLBACK_VERSION = "2.1.277";
     pExecFile2 = promisify(execFile);
   }
@@ -1237,15 +1254,21 @@ function contentScreenCall(opts) {
     `${indent}fi`
   ].join("\n");
 }
-function localHookCall(hook) {
+function localHookCall(hook, feedRefs = false) {
+  const refsCapture = feedRefs ? `# git hands the pushed refs to pre-push ONCE, on stdin \u2014 one line per ref:
+# "<local ref> <local sha> <remote ref> <remote sha>". The shell gate below reads them too, so
+# they are captured here and fed to each.
+refs=$(cat)
+` : "";
+  const call = feedRefs ? `printf '%s\\n' "$refs" | "$LOCAL" "$@" || exit 1` : `"$LOCAL" "$@" || exit 1`;
   return `# Repo-owned checks. This file is generated and will be overwritten; \`.githooks/${hook}.local\`
 # is yours \u2014 etymd never reads, writes, or regenerates it. Put project-specific guards there.
 # A guard running tests that build fixture repositories should scrub git's exported GIT_* names
 # first \u2014 a child git inherits them and ignores its cwd, so the suite would hit the real repo:
 #   env $(env | grep -o '^GIT_[A-Za-z0-9_]*' | sed 's/^/-u /') <your command>
 LOCAL="$(dirname "$0")/${hook}.local"
-if [ -x "$LOCAL" ]; then
-  "$LOCAL" "$@" || exit 1
+${refsCapture}if [ -x "$LOCAL" ]; then
+  ${call}
 fi`;
 }
 function generatePreCommitHook(selfBuild = false) {
@@ -1254,10 +1277,10 @@ function generatePreCommitHook(selfBuild = false) {
 
 ${localHookCall("pre-commit")}
 
-# Content screen \u2014 staged file bytes. Refuses to commit environment, guarded-side or identity
-# detail into a repo whose history is (or could become) public. The checker and its patterns
-# are machine-local by design, so this is a NO-OP wherever no checker is installed: safe to
-# commit anywhere, active only where you opted in.
+# Content screen \u2014 staged file bytes. Refuses to commit detail about your environment, work
+# or identity into a repo whose history is (or could become) public. The checker and its
+# patterns are machine-local by design, so this is a NO-OP wherever no checker is installed:
+# safe to commit anywhere, active only where you opted in.
 #
 # Bypass, with a reason: git commit --no-verify
 ${contentGateResolution(selfBuild)}
@@ -1318,17 +1341,18 @@ function generateShellDiscoveryScript() {
 # side, positional here). Verdicts land in the scratch: scripts (NUL-delimited matches) and one
 # dot per decision into count / zsh-count / skip-count, tallied by the hook after the pipeline.
 #
-# A path with nothing readable behind it \u2014 a submodule entry, a dangling symlink, a file
-# deleted from the worktree while still tracked \u2014 cannot lie about its contents, so it is a
-# disclosed skip, never a block: an absent worktree file is routine dirty state. A regular file
+# The hook runs it from inside a commit materialised from git's object store, so paths resolve
+# against that tree, never the working tree. A path with nothing readable behind it \u2014 a
+# submodule entry, a dangling symlink \u2014 cannot lie about its contents, so it is a disclosed
+# skip, never a block. A regular file
 # that EXISTS but cannot be read is the other branch \u2014 coverage would silently shrink, so it
 # fails, naming the path.
 #
-# The two \`[ "$?" -eq 1 ]\` guards are the match/error protocol: grep reports "no match" as 1
-# and a failure as 2 or more, and only the first is a verdict. Dropping the guard would let a
-# failing matcher pass as "not a shell script" \u2014 the exact silent coverage-shrink the
-# fail-closed rules exist to prevent. The checker does not associate \`$?\` with the enclosing
-# if-condition, which is why this shape survives the pass it serves; keep it that way.
+# The match/error protocol: grep reports "no match" as 1 and a failure as 2 or more, and only
+# the first is a verdict. Letting a failure fall through would pass a broken matcher as "not a
+# shell script" \u2014 the exact silent coverage-shrink the fail-closed rules exist to prevent. The
+# status is captured on the grep's own line (\`|| st=$?\`), so no command added later can come
+# between the grep and the check and silently replace the status being read.
 work=$1
 shift
 for file do
@@ -1344,33 +1368,42 @@ for file do
     exit 1
   }
   head -n 1 "$work/head-bytes" > "$work/first-line" || exit 1
-  if grep -qE "^#!.*[/ ](ba|da)?sh( |$)" "$work/first-line"; then
-    printf "./%s\\0" "$file" >> "$work/scripts" || exit 1
-    printf . >> "$work/count" || exit 1
-  else
-    [ "$?" -eq 1 ] || exit 1
-    if grep -qE "^#!.*[/ ]zsh( |$)" "$work/first-line"; then
-      printf . >> "$work/zsh-count" || exit 1
-    else
-      [ "$?" -eq 1 ] || exit 1
-    fi
-  fi
+  st=0
+  grep -qE "^#!.*[/ ](ba|da)?sh( |$)" "$work/first-line" || st=$?
+  case $st in
+    (0)
+      printf "./%s\\0" "$file" >> "$work/scripts" || exit 1
+      printf . >> "$work/count" || exit 1 ;;
+    (1)
+      st=0
+      grep -qE "^#!.*[/ ]zsh( |$)" "$work/first-line" || st=$?
+      case $st in
+        (0) printf . >> "$work/zsh-count" || exit 1 ;;
+        (1) ;;
+        (*) exit 1 ;;
+      esac ;;
+    (*) exit 1 ;;
+  esac
 done
 `);
 }
 function shellcheckStep() {
   return `
 # Shell correctness. Scripts are discovered by shebang over TRACKED files at push time, so a
-# script added later is covered without regenerating this hook. The classifier is
-# discover-shell-scripts.sh beside this hook \u2014 tracked and shebanged like what it classifies,
+# script added later is covered without regenerating this hook. The commits BEING PUSHED are
+# the bytes that ship, so each one is materialised from git's object store and checked there \u2014
+# never the working tree (wrong in both directions: a fixed tree let an unfixed commit ship, and
+# a dirty tree shared by several sessions blocked an unrelated push) and never the tip alone (a
+# bad commit under a clean tip shipped while the gate read only the tip's fix). The classifier
+# is discover-shell-scripts.sh beside this hook \u2014 tracked and shebanged like what it classifies,
 # so the scan it implements finds and checks it too. zsh is NOT in the checked set:
 # the checker cannot parse it (SC1071 is a parser-level error no inline directive can silence),
 # so checking it would fail every push on the parser, not on the script. Excluded \u2014 and said so
 # at run time below, because a coverage hole that is silent is indistinguishable from coverage.
 # The same honesty splits the unreadable: a regular file that exists but cannot be read blocks
 # the push (coverage would otherwise silently shrink), while a tracked path with nothing readable
-# behind it \u2014 a submodule entry, a dangling symlink, a file deleted from the worktree while
-# still tracked \u2014 is counted and said so below as skipped, never a block.
+# behind it \u2014 a submodule entry, a dangling symlink \u2014 is counted and said so below as skipped,
+# never a block.
 #
 # "the checker", not its name, on purpose: a comment whose first word is that name is read as
 # a DIRECTIVE, and an unparseable directive is itself an error (SC1072/SC1073). A hook that
@@ -1389,39 +1422,143 @@ if command -v shellcheck >/dev/null 2>&1; then
     shellcheck_tmp=$(mktemp -d) || exit 1
     trap 'rm -rf "$shellcheck_tmp"' 0
     trap 'exit 1' 1 2 3 15
-    git ls-files -z > "$shellcheck_tmp/tracked" || {
-      echo "etymd: cannot enumerate tracked files for shellcheck" >&2
-      exit 1
-    }
-    : > "$shellcheck_tmp/scripts" && : > "$shellcheck_tmp/count" && : > "$shellcheck_tmp/zsh-count" && : > "$shellcheck_tmp/skip-count" || exit 1
-    xargs -0 "$(dirname "$0")/discover-shell-scripts.sh" "$shellcheck_tmp" < "$shellcheck_tmp/tracked" || {
-      echo "etymd: shell script discovery failed; shellcheck coverage is incomplete" >&2
+    # Every commit in each pushed range, never the tip alone: pushing two commits \u2014 a bad
+    # script, then its fix \u2014 passed a tip-only read while the bad commit landed on the remote.
+    # An all-zero local sha is a delete (nothing to check). An all-zero REMOTE sha is a new
+    # branch: everything no remote already has is being pushed, so the range is the local sha
+    # minus every remote-tracking ref \u2014 commits a remote already received were gated when they
+    # landed there, and the residue is exactly this push's new commits. A remote sha this clone
+    # has never seen (the remote moved on since the last fetch) cannot bound a range, so it takes
+    # the same new-branch rule instead of refusing a push the gate could have read. Enumeration
+    # failure refuses the push: a range the gate could not list is a range it did not read.
+    # (pattern) with both parens: bash 3.2 (macOS /bin/sh) cannot parse an unbalanced )
+    # in a case pattern.
+    : > "$shellcheck_tmp/shas" || exit 1
+    printf '%s\\n' "$refs" | while read -r _lref lsha _rref rsha; do
+      case "$lsha" in
+        (*[!0]*) ;;
+        (*) continue ;;
+      esac
+      case "$rsha" in
+        (*[!0]*)
+          if git cat-file -e "\${rsha}^{commit}" 2>/dev/null; then
+            git rev-list "$rsha..$lsha"
+          else
+            git rev-list "$lsha" --not --remotes
+          fi ;;
+        (*) git rev-list "$lsha" --not --remotes ;;
+      esac >> "$shellcheck_tmp/shas" || exit 1
+    done || {
+      echo "etymd: could not enumerate the commits being pushed for shellcheck" >&2
       exit 1
     }
-    count=$(wc -c < "$shellcheck_tmp/count") || exit 1
-    zsh_count=$(wc -c < "$shellcheck_tmp/zsh-count") || exit 1
-    skip_count=$(wc -c < "$shellcheck_tmp/skip-count") || exit 1
-    if [ "$skip_count" -gt 0 ]; then
-      echo "\u203A shellcheck: $((skip_count)) tracked path(s) with nothing readable behind them (submodule, dangling symlink, or deleted from the worktree) \u2014 not checked, not failed"
-    fi
-    if [ "$zsh_count" -gt 0 ]; then
-      echo "\u203A shellcheck: $((zsh_count)) zsh script(s) excluded \u2014 shellcheck cannot parse zsh (SC1071); not checked, not failed"
+    shas=$(sort -u "$shellcheck_tmp/shas") || exit 1
+    if [ -n "$shas" ]; then
+      # Said up front: a first push from a fresh clone can carry the whole history, and a long
+      # silent hook reads as a hung one.
+      echo "\u203A shellcheck: $(printf '%s\\n' "$shas" | wc -l | tr -d ' ') commit(s) in the pushed range"
+    else
+      echo "\u203A shellcheck: no commit in the pushed refs (deletes only, or nothing on stdin) \u2014 nothing to check"
     fi
-    if [ "$count" -gt 0 ]; then
-      echo "\u203A shellcheck ($((count)) scripts, blocking at severity=warning)"
-      xargs -0 shellcheck -S warning -- < "$shellcheck_tmp/scripts" || {
-        echo "  fix, or justify inline with '# shellcheck disable=SCxxxx  # why'"
+    # Resolved once, before any cd: the classifier runs inside each materialised tree, and a
+    # relative hook path would no longer point at it from there.
+    discover="$(cd "$(dirname "$0")" && pwd)/discover-shell-scripts.sh" || exit 1
+    for sha in $shas; do
+      # A fresh directory per commit, removed once that commit is checked so a long push does
+      # not pile up one full tree per commit; the subshell trap above still cleans the root on
+      # every early exit.
+      tree=$(mktemp -d "$shellcheck_tmp/commit.XXXXXX") || exit 1
+      # Checked out through a scratch index, never \`git archive\`: archive honours the
+      # export-ignore and export-subst attributes, so a script marked export-ignore would leave
+      # the checked set without a word. read-tree + checkout-index writes every tracked blob.
+      # Large-file pointers stay pointers \u2014 they are never shell, and a push must not need the
+      # network to be checked.
+      if ! git cat-file -e "\${sha}^{commit}" 2>/dev/null \\
+         || ! GIT_INDEX_FILE="$shellcheck_tmp/index" git read-tree "$sha" 2>/dev/null \\
+         || ! GIT_INDEX_FILE="$shellcheck_tmp/index" GIT_LFS_SKIP_SMUDGE=1 \\
+              git checkout-index -a -f --prefix="$tree/" 2>/dev/null; then
+        echo "\u2717 shellcheck: could not materialise $(git rev-parse --short "$sha" 2>/dev/null || echo "$sha") \u2014 refusing the push rather than certifying bytes this gate did not read" >&2
+        exit 1
+      fi
+      if [ -n "$(git ls-tree -r --name-only "$sha")" ] && [ -z "$(ls -A "$tree")" ]; then
+        echo "\u2717 shellcheck: $(git rev-parse --short "$sha" 2>/dev/null || echo "$sha") extracted to an empty tree \u2014 refusing the push" >&2
+        exit 1
+      fi
+      : > "$shellcheck_tmp/scripts" && : > "$shellcheck_tmp/count" && : > "$shellcheck_tmp/zsh-count" && : > "$shellcheck_tmp/skip-count" || exit 1
+      # Only the paths this commit adds, copies, modifies, renames or retypes against its first
+      # parent. A script the commit did not touch has its parent's bytes, and that parent was
+      # either gated when it reached the remote or sits in this range and is checked here; a
+      # merge diffed against its first parent brings in everything the other side added.
+      # Checking every script in every commit multiplied the cost by the range length, so a long
+      # push of a script-heavy repo ran long enough to look hung. Two changes alter the verdict
+      # on bytes nobody touched \u2014 the classifier deciding what is a script, and a .shellcheckrc
+      # deciding what is a finding \u2014 so a commit that touches either, deletion included (a
+      # removed .shellcheckrc re-enables every check it disabled), is checked whole. So is a
+      # commit that adds or changes this hook: a repo adopting the gate after the fact has
+      # scripts no gate ever read, and the commit installing it is where they get read once.
+      short=$(git rev-parse --short "$sha" 2>/dev/null || echo "$sha")
+      if git rev-parse -q --verify "\${sha}^1^{commit}" >/dev/null 2>&1; then
+        git diff-tree -r -z --name-only --no-commit-id "\${sha}^1" "$sha" > "$shellcheck_tmp/touched" \\
+          && git diff-tree -r -z --name-only --no-commit-id --diff-filter=ACMRT "\${sha}^1" "$sha" > "$shellcheck_tmp/tracked"
+      else
+        git diff-tree -r -z --name-only --no-commit-id --root "$sha" > "$shellcheck_tmp/touched" \\
+          && cp "$shellcheck_tmp/touched" "$shellcheck_tmp/tracked"
+      fi || {
+        echo "etymd: cannot enumerate the paths $short changes for shellcheck" >&2
         exit 1
       }
-      # Everything below the blocking bar, shown once the push is already cleared. Never affects
-      # the exit code \u2014 advice that can fail a push is not advice.
-      advice=$(xargs -0 shellcheck -S style -f gcc -- < "$shellcheck_tmp/scripts" 2>/dev/null \\
-        | grep -v ': warning:\\|: error:' || true)
-      if [ -n "$advice" ]; then
-        echo "  \xB7 style/info (not blocking):"
-        printf '%s\\n' "$advice" | sed 's/^/    /'
+      where="changed in $short"
+      # Through a file, not a pipe: a pipeline reports only grep's status, and a failing tr would
+      # hand grep nothing \u2014 a "no match" that silently takes the narrow path.
+      tr '\\000' '\\n' < "$shellcheck_tmp/touched" > "$shellcheck_tmp/touched-lines" || exit 1
+      # grep: 1 is "no match", a verdict; anything higher is the matcher failing. The status is
+      # taken on the grep's own line so nothing added later can come between them.
+      st=0
+      grep -qE '(^|/)(\\.shellcheckrc|discover-shell-scripts\\.sh|pre-push)$' "$shellcheck_tmp/touched-lines" || st=$?
+      case $st in
+        (0)
+          where="in $short (whole tree: the gate, its classifier or a .shellcheckrc changed)"
+          git ls-tree -r -z --name-only "$sha" > "$shellcheck_tmp/tracked" || {
+            echo "etymd: cannot enumerate the tree of $short for shellcheck" >&2
+            exit 1
+          } ;;
+        (1) ;;
+        (*)
+          echo "etymd: shell script discovery failed; cannot tell whether $short changes the gate, its classifier or a .shellcheckrc" >&2
+          exit 1 ;;
+      esac
+      ( cd "$tree" && xargs -0 "$discover" "$shellcheck_tmp" ) < "$shellcheck_tmp/tracked" || {
+        echo "etymd: shell script discovery failed; shellcheck coverage is incomplete" >&2
+        exit 1
+      }
+      count=$(wc -c < "$shellcheck_tmp/count") || exit 1
+      zsh_count=$(wc -c < "$shellcheck_tmp/zsh-count") || exit 1
+      skip_count=$(wc -c < "$shellcheck_tmp/skip-count") || exit 1
+      if [ "$skip_count" -gt 0 ]; then
+        echo "\u203A shellcheck: $((skip_count)) tracked path(s) with nothing readable behind them (submodule or dangling symlink) \u2014 not checked, not failed"
       fi
-    fi
+      if [ "$zsh_count" -gt 0 ]; then
+        echo "\u203A shellcheck: $((zsh_count)) zsh script(s) excluded \u2014 shellcheck cannot parse zsh (SC1071); not checked, not failed"
+      fi
+      if [ "$count" -eq 0 ]; then
+        echo "\u203A shellcheck: no shell script $where \u2014 nothing to check there"
+      else
+        echo "\u203A shellcheck ($((count)) scripts $where, blocking at severity=warning)"
+        ( cd "$tree" && xargs -0 shellcheck -S warning -- < "$shellcheck_tmp/scripts" ) || {
+          echo "  fix, or justify inline with '# shellcheck disable=SCxxxx  # why'"
+          exit 1
+        }
+        # Everything below the blocking bar, shown once the push is already cleared. Never affects
+        # the exit code \u2014 advice that can fail a push is not advice.
+        advice=$( ( cd "$tree" && xargs -0 shellcheck -S style -f gcc -- < "$shellcheck_tmp/scripts" 2>/dev/null ) \\
+          | grep -v ': warning:\\|: error:' || true)
+        if [ -n "$advice" ]; then
+          echo "  \xB7 style/info (not blocking):"
+          printf '%s\\n' "$advice" | sed 's/^/    /'
+        fi
+      fi
+      rm -rf "$tree" || exit 1
+    done
   ) || exit 1
 else
   echo "\u203A shellcheck skipped (not on PATH) \u2014 install it to gate this repo's shell scripts"
@@ -1455,7 +1592,7 @@ fi`;
   return stampGenerated(`#!/usr/bin/env sh
 # etymd: correctness gate. Mirrors CI cheapest-first; blocks the push on any failure.
 
-${localHookCall("pre-push")}${runner}
+${localHookCall("pre-push", true)}${runner}
 ${body}${shellStep}
 ${auditStep}
 

package/dist/{init-7HWVHZMF.js → init-SL3HEB3H.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { applyFiles } from './chunk-GWGKEPRX.js';
-import { planWorkflow } from './chunk-EZRK4MV3.js';
-import './chunk-HSRHOVII.js';
+import { planWorkflow } from './chunk-TZGRV7UY.js';
+import './chunk-X5GR2EJK.js';
 import { theme, renderFacts, print, renderPlan, section, glyph } from './chunk-HI7NWPRA.js';
-import { scanProject } from './chunk-DLHC7QON.js';
-import { VERSION } from './chunk-L4KIIKXI.js';
+import { scanProject, checkClaudePointer } from './chunk-OKHNNWOV.js';
+import { VERSION } from './chunk-W6GGG4LG.js';
 import { writeCachedFacts, deriveProfile, writeBaseline, CACHE_DIR } from './chunk-P6ATKV2R.js';
-import { PACK_VERSION } from './chunk-U7BCBJIH.js';
+import { PACK_VERSION } from './chunk-6FT7KSKU.js';
 import { git, readText } from './chunk-4VPBP6K6.js';
 import { promises } from 'fs';
 import path from 'path';
@@ -102,6 +102,13 @@ async function run(opts) {
   section("Onboarded");
   for (const w of result.written) print(`  ${glyph.ok} ${theme.dim("wrote")} ${theme.info(w)}`);
   for (const sk of result.skipped) print(`  ${glyph.bullet} ${theme.dim("kept")} ${theme.dim(sk)}`);
+  const pointer = await checkClaudePointer(opts.cwd);
+  if (!pointer.ok && pointer.kind === "no-import") {
+    const line = pointer.detail.includes(".claude/CLAUDE.md") ? "@../AGENTS.md" : "@AGENTS.md";
+    print(
+      `  ${glyph.partial} ${theme.warn(pointer.detail)} ${theme.dim(`\u2014 Claude Code reads that file instead; add a full-line ${line} import`)}`
+    );
+  }
   print(
     `  ${glyph.ok} ${theme.dim("baseline approved \u2192")} ${theme.info(".etymd/baseline.json")} ${theme.dim("(commit it \u2014 drift is measured against it)")}`
   );

package/dist/{premise-U6JIB2QG.js → premise-62AXRQUK.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { parseFailOnTier, meetsFailOn, buildTruthEnv, emptyCounters, checkTextClaims, checkDocRefs, loadDecisionLedger, checkDecisionRefs, rankFindings, PATH_TOKEN_RE, HOSTNAME_RE, KNOWN_EXTENSIONS, NAMESPACE_IDENT, NAMESPACE_STOP } from './chunk-EYUW3UJU.js';
+import { parseFailOnTier, meetsFailOn, buildTruthEnv, emptyCounters, checkTextClaims, checkDocRefs, loadDecisionLedger, checkDecisionRefs, rankFindings, PATH_TOKEN_RE, HOSTNAME_RE, KNOWN_EXTENSIONS, NAMESPACE_IDENT, NAMESPACE_STOP } from './chunk-DWPMANIC.js';
 import { print, section, theme, renderFindings } from './chunk-HI7NWPRA.js';
-import { scanProject } from './chunk-DLHC7QON.js';
-import './chunk-L4KIIKXI.js';
+import { scanProject } from './chunk-OKHNNWOV.js';
+import './chunk-W6GGG4LG.js';
 import { ETYMD_DIR } from './chunk-P6ATKV2R.js';
-import './chunk-U7BCBJIH.js';
+import './chunk-6FT7KSKU.js';
 import { readText, pathExists } from './chunk-4VPBP6K6.js';
 import path from 'path';
 import { promises } from 'fs';

package/dist/{propose-NZMEPZIL.js → propose-4UWLIFWJ.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-import { sweepFleet, loadFleetManifest, FLEET_JSON_SCHEMA } from './chunk-ZCOIZVSM.js';
-import './chunk-KIPD3N77.js';
-import './chunk-EYUW3UJU.js';
+import { sweepFleet, loadFleetManifest, FLEET_JSON_SCHEMA } from './chunk-WIBN7PBH.js';
+import './chunk-FG5XKFR2.js';
+import './chunk-DWPMANIC.js';
 import './chunk-3E2IPCRY.js';
 import { print, section, theme, renderFleetNotes } from './chunk-HI7NWPRA.js';
-import './chunk-DLHC7QON.js';
-import './chunk-L4KIIKXI.js';
+import './chunk-OKHNNWOV.js';
+import './chunk-W6GGG4LG.js';
 import './chunk-P6ATKV2R.js';
-import './chunk-U7BCBJIH.js';
+import './chunk-6FT7KSKU.js';
 import { readText } from './chunk-4VPBP6K6.js';
 import path from 'path';
 

package/dist/scan-M7STYIYQ.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+export { scanProject } from './chunk-OKHNNWOV.js';
+import './chunk-W6GGG4LG.js';
+import './chunk-6FT7KSKU.js';
+import './chunk-4VPBP6K6.js';

package/dist/{scan-DLKYG5BB.js → scan-VEHQEEXY.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { print, renderFacts, theme } from './chunk-HI7NWPRA.js';
-import { scanProject } from './chunk-DLHC7QON.js';
-import './chunk-L4KIIKXI.js';
+import { scanProject } from './chunk-OKHNNWOV.js';
+import './chunk-W6GGG4LG.js';
 import { writeCachedFacts } from './chunk-P6ATKV2R.js';
-import './chunk-U7BCBJIH.js';
+import './chunk-6FT7KSKU.js';
 import './chunk-4VPBP6K6.js';
 
 // src/commands/scan.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "etymd",
-  "version": "0.19.0",
+  "version": "0.19.2",
   "description": "Keep your agent instructions true — verify AGENTS.md, CLAUDE.md, rules, skills, and the task you hand an agent against the actual repo, with drift caught over time and a regression ledger.",
   "keywords": [
     "cli",

package/dist/audit-RONSEYFS.js

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-export { run } from './chunk-4IESOWHQ.js';
-import './chunk-KIPD3N77.js';
-import './chunk-EYUW3UJU.js';
-import './chunk-3E2IPCRY.js';
-import './chunk-HI7NWPRA.js';
-import './chunk-DLHC7QON.js';
-import './chunk-L4KIIKXI.js';
-import './chunk-P6ATKV2R.js';
-import './chunk-U7BCBJIH.js';
-import './chunk-4VPBP6K6.js';

package/dist/scan-V53PGAQ6.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-export { scanProject } from './chunk-DLHC7QON.js';
-import './chunk-L4KIIKXI.js';
-import './chunk-U7BCBJIH.js';
-import './chunk-4VPBP6K6.js';