etymd 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # etymd
 
+## 0.4.1
+
+### Patch Changes
+
+- 915ae78: Fix: the shell gate now actually prints the sub-warning findings it documented.
+
+  0.4.0 said "style and info print as advice" and did not do it — the generated hook ran only
+  `shellcheck -S warning` and discarded everything below that bar. The generated file made no such
+  claim, so no repo was misled about what its own gate does, but the promise was in the release
+  notes and not in the code.
+
+  The hook now runs a second, non-blocking pass after the blocking one and prints what it finds.
+  Its result is captured into a variable and explicitly tolerated with `|| true`, so it has no path
+  to the exit code: advice that can fail a push is not advice. The blocking bar is unchanged.
+
+  The test that was supposed to protect this pinned the wrong property — it asserted that style was
+  never MENTIONED, which the buggy version satisfied. It now asserts that the warning pass is the
+  only one wired to a failure branch, which is the property that actually matters.
+
+  Pack version 5.
+
 ## 0.4.0
 
 ### Minor Changes

package/dist/{approve-Y6TX4LTN.js → approve-DTYNGGXH.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { section, theme, print, renderBaselineDrift, glyph } from './chunk-TADKOW6P.js';
-import { scanProject } from './chunk-SXCR6RRM.js';
-import { VERSION } from './chunk-QYHROOMK.js';
+import { scanProject } from './chunk-RH2UAS25.js';
+import { VERSION } from './chunk-KIMFKLJB.js';
 import { readBaseline, summarizeBaselineDrift, isDriftEmpty, writeBaseline, deriveProfile } from './chunk-R74SJ7HS.js';
-import { PACK_VERSION } from './chunk-HGSLHNNT.js';
+import { PACK_VERSION } from './chunk-IGHES6AK.js';
 import './chunk-YLNQQZ5F.js';
 
 // src/commands/approve.ts

package/dist/{audit-AU4R45TP.js → audit-UJU3336P.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-export { run } from './chunk-7K3BDNLW.js';
-import './chunk-ECY7BLBT.js';
+export { run } from './chunk-XER37MLS.js';
+import './chunk-OWNWN2KF.js';
 import './chunk-LT67FU2Y.js';
 import './chunk-WWBF4Y7K.js';
 import './chunk-NMZ3RHWW.js';
 import './chunk-TADKOW6P.js';
-import './chunk-SXCR6RRM.js';
-import './chunk-QYHROOMK.js';
+import './chunk-RH2UAS25.js';
+import './chunk-KIMFKLJB.js';
 import './chunk-R74SJ7HS.js';
-import './chunk-HGSLHNNT.js';
+import './chunk-IGHES6AK.js';
 import './chunk-YLNQQZ5F.js';

package/dist/{brief-TIKPGPFV.js → brief-5UZLZ3CW.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { print, theme } from './chunk-TADKOW6P.js';
-import { scanProject } from './chunk-SXCR6RRM.js';
-import './chunk-QYHROOMK.js';
+import { scanProject } from './chunk-RH2UAS25.js';
+import './chunk-KIMFKLJB.js';
 import { ETYMD_DIR } from './chunk-R74SJ7HS.js';
-import './chunk-HGSLHNNT.js';
+import './chunk-IGHES6AK.js';
 import './chunk-YLNQQZ5F.js';
 import { promises } from 'node:fs';
 import path from 'node:path';

package/dist/{chunk-HGSLHNNT.js → chunk-IGHES6AK.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 // src/pack/version.ts
-var PACK_VERSION = "4";
+var PACK_VERSION = "5";
 
 export { PACK_VERSION };

package/dist/{chunk-QYHROOMK.js → chunk-KIMFKLJB.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // package.json
 var package_default = {
-  version: "0.4.0"};
+  version: "0.4.1"};
 
 // src/version.ts
 var VERSION = package_default.version;

package/dist/{chunk-ECY7BLBT.js → chunk-OWNWN2KF.js}

@@ -2,9 +2,9 @@
 import { measureContext } from './chunk-LT67FU2Y.js';
 import { readLedger, reconcileLedger, writeLedger, visibleFindings } from './chunk-WWBF4Y7K.js';
 import { DEFAULT_CONFIG, readConfig, CONFIG_FILE } from './chunk-NMZ3RHWW.js';
-import { scanProject, expandFileGlobs } from './chunk-SXCR6RRM.js';
+import { scanProject, expandFileGlobs } from './chunk-RH2UAS25.js';
 import { ETYMD_DIR, writeCachedFacts, readBaseline, deriveProfile, baselineCarriesMachinePath, BASELINE_FILE } from './chunk-R74SJ7HS.js';
-import { PACK_VERSION } from './chunk-HGSLHNNT.js';
+import { PACK_VERSION } from './chunk-IGHES6AK.js';
 import { pathExists, readJson, git, readText, isDirectory, matchesAnyGlob, isCiEnvironment, normalizeRelPath } from './chunk-YLNQQZ5F.js';
 import path from 'node:path';
 import YAML from 'yaml';

package/dist/{chunk-JTHZVEON.js → chunk-OX3LUOZR.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { DEFAULT_CONFIG } from './chunk-NMZ3RHWW.js';
-import { PACK_VERSION } from './chunk-HGSLHNNT.js';
+import { PACK_VERSION } from './chunk-IGHES6AK.js';
 import { readText, pathExists } from './chunk-YLNQQZ5F.js';
 import path from 'node:path';
 
@@ -172,6 +172,14 @@ if command -v shellcheck >/dev/null 2>&1; then
       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=$(printf '%s\\n' "$scripts" | xargs shellcheck -S style -f gcc 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
 else
   echo "\u203A shellcheck skipped (not on PATH) \u2014 install it to gate this repo's shell scripts"

package/dist/{chunk-SXCR6RRM.js → chunk-RH2UAS25.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { VERSION } from './chunk-QYHROOMK.js';
-import { PACK_VERSION } from './chunk-HGSLHNNT.js';
+import { VERSION } from './chunk-KIMFKLJB.js';
+import { PACK_VERSION } from './chunk-IGHES6AK.js';
 import { normalizeRelPath, isDirectory, readJson, git, matchesAnyGlob, pathExists, readText } from './chunk-YLNQQZ5F.js';
 import path from 'node:path';
 import { promises } from 'node:fs';

package/dist/{chunk-7K3BDNLW.js → chunk-XER37MLS.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { parseFailOnTier, runAudit, meetsFailOn } from './chunk-ECY7BLBT.js';
+import { parseFailOnTier, runAudit, meetsFailOn } from './chunk-OWNWN2KF.js';
 import { print, section, theme, renderLensCoverage, renderFindings, renderLedgerDiff } from './chunk-TADKOW6P.js';
 
 // src/commands/audit.ts

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { VERSION } from './chunk-QYHROOMK.js';
+import { VERSION } from './chunk-KIMFKLJB.js';
 import path from 'node:path';
 import { Command } from 'commander';
 import pc from 'picocolors';
@@ -31,7 +31,7 @@ program.command("audit").description("Verify every instruction claim against the
   "exit non-zero when findings at/above this tier exist (risk|gap|polish)"
 ).action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./audit-AU4R45TP.js');
+    const { run } = await import('./audit-UJU3336P.js');
     await run({
       cwd: resolveCwd(cmd),
       json: opts.json,
@@ -44,7 +44,7 @@ program.command("audit").description("Verify every instruction claim against the
 );
 program.command("init").description("Onboard the truth guard: approve the baseline; scaffold AGENTS.md only if missing").option("-y, --yes", "accept defaults without prompting (never overwrites)").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./init-BYZJOCS6.js');
+    const { run } = await import('./init-7GNB74BE.js');
     await run({ cwd: resolveCwd(cmd), yes: opts.yes });
   })
 );
@@ -52,19 +52,19 @@ program.command("approve").description(
   "Re-approve the committed baseline after intentional structural changes (non-interactive)"
 ).action(
   (_opts, cmd) => action(async () => {
-    const { run } = await import('./approve-Y6TX4LTN.js');
+    const { run } = await import('./approve-DTYNGGXH.js');
     await run({ cwd: resolveCwd(cmd) });
   })
 );
 program.command("scan").description("Deterministically reckon the project into a facts index").option("--json", "print the raw facts as JSON").option("--no-save", "do not write the .etymd cache").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./scan-DPEOA3KZ.js');
+    const { run } = await import('./scan-6YOKI3JW.js');
     await run({ cwd: resolveCwd(cmd), json: opts.json, save: opts.save });
   })
 );
 program.command("doctor").description('Alias for `audit --truth` \u2014 "are the recorded instructions still true?"').option("--json", "print findings as JSON").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./doctor-OE5E36DX.js');
+    const { run } = await import('./doctor-W6DW3OK6.js');
     await run({ cwd: resolveCwd(cmd), json: opts.json });
   })
 );
@@ -76,7 +76,7 @@ program.command("context").description("Measure the always-loaded context footpr
 );
 program.command("brief").description("Emit a grounded briefing for the in-repo agent to complete the semantic layer").option("--human", "write a human onboarding brief instead of the agent briefing").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./brief-TIKPGPFV.js');
+    const { run } = await import('./brief-5UZLZ3CW.js');
     await run({ cwd: resolveCwd(cmd), human: opts.human });
   })
 );
@@ -111,7 +111,7 @@ var fleet = program.command("fleet").description(
   "exit non-zero when findings at/above this tier exist (risk|gap|polish)"
 ).action(
   (opts, cmd) => action(async () => {
-    const { sweep } = await import('./fleet-LSN5XZ5Q.js');
+    const { sweep } = await import('./fleet-77SSSFZO.js');
     await sweep({
       cwd: resolveCwd(cmd),
       manifest: opts.manifest,
@@ -126,7 +126,7 @@ var fleet = program.command("fleet").description(
 );
 fleet.command("check").description("Validate the manifest pair only \u2014 no lenses: dangling mappings, duplicates, leaks").option("--manifest <file>", "the fleet manifest \u2014 required unless the cwd holds registry.json").option("--json", "print the findings as JSON (EXPERIMENTAL through 0.2.x)").action(
   (_opts, cmd) => action(async () => {
-    const { check } = await import('./fleet-LSN5XZ5Q.js');
+    const { check } = await import('./fleet-77SSSFZO.js');
     const opts = cmd.optsWithGlobals();
     await check({ cwd: resolveCwd(cmd), manifest: opts.manifest, json: opts.json });
   })
@@ -136,7 +136,7 @@ fleet.command("add").argument("<dir>", "directory of the project to register").d
   "public-repo | public-bound | private \u2014 mandatory for personal entries"
 ).option("-y, --yes", "skip prompts; every mandatory value must be passed as a flag").option("--manifest <file>", "the fleet manifest \u2014 required unless the cwd holds registry.json").action(
   (dir, opts, cmd) => action(async () => {
-    const { add } = await import('./fleet-LSN5XZ5Q.js');
+    const { add } = await import('./fleet-77SSSFZO.js');
     const shared = cmd.optsWithGlobals();
     await add({
       cwd: resolveCwd(cmd),
@@ -154,7 +154,7 @@ fleet.command("dismiss").argument("<name>", "the registered project name").argum
   "Dismiss a project's finding from any cwd \u2014 corp ledgers persist beside the manifest"
 ).requiredOption("--reason <text>", "why it is dismissed \u2014 recorded so the decision survives").option("--manifest <file>", "the fleet manifest \u2014 required unless the cwd holds registry.json").action(
   (name, id, _opts, cmd) => action(async () => {
-    const { dismiss } = await import('./fleet-LSN5XZ5Q.js');
+    const { dismiss } = await import('./fleet-77SSSFZO.js');
     const opts = cmd.optsWithGlobals();
     await dismiss({
       cwd: resolveCwd(cmd),
@@ -169,7 +169,7 @@ fleet.command("accept").argument("<name>", "the registered project name").argume
   "Accept a project's finding as a known trade-off \u2014 corp ledgers persist beside the manifest"
 ).option("--reason <text>", "optional note on why the trade-off is accepted").option("--manifest <file>", "the fleet manifest \u2014 required unless the cwd holds registry.json").action(
   (name, id, _opts, cmd) => action(async () => {
-    const { accept } = await import('./fleet-LSN5XZ5Q.js');
+    const { accept } = await import('./fleet-77SSSFZO.js');
     const opts = cmd.optsWithGlobals();
     await accept({ cwd: resolveCwd(cmd), manifest: opts.manifest, name, id, reason: opts.reason });
   })
@@ -191,7 +191,7 @@ program.command("screen").description(
 );
 program.command("gates").description("Install the local git-hook gates (process \u2192 pre-commit, correctness \u2192 pre-push)").option("--ci", "note about the CI review gate (ships later; local gates install now)").option("-y, --yes", "skip prompts; never overwrites a hand-edited hook").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./gates-IJNAQ7DC.js');
+    const { run } = await import('./gates-LTM5PE7R.js');
     await run({ cwd: resolveCwd(cmd), ci: opts.ci, yes: opts.yes });
   })
 );

package/dist/{doctor-OE5E36DX.js → doctor-W6DW3OK6.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import { run } from './chunk-7K3BDNLW.js';
-import './chunk-ECY7BLBT.js';
+import { run } from './chunk-XER37MLS.js';
+import './chunk-OWNWN2KF.js';
 import './chunk-LT67FU2Y.js';
 import './chunk-WWBF4Y7K.js';
 import './chunk-NMZ3RHWW.js';
 import './chunk-TADKOW6P.js';
-import './chunk-SXCR6RRM.js';
-import './chunk-QYHROOMK.js';
+import './chunk-RH2UAS25.js';
+import './chunk-KIMFKLJB.js';
 import './chunk-R74SJ7HS.js';
-import './chunk-HGSLHNNT.js';
+import './chunk-IGHES6AK.js';
 import './chunk-YLNQQZ5F.js';
 
 // src/commands/doctor.ts

package/dist/{fleet-LSN5XZ5Q.js → fleet-77SSSFZO.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import { dismiss, accept } from './chunk-MMPV67FW.js';
-import { parseFailOnTier, meetsFailOn, runAudit } from './chunk-ECY7BLBT.js';
+import { parseFailOnTier, meetsFailOn, runAudit } from './chunk-OWNWN2KF.js';
 import './chunk-LT67FU2Y.js';
 import { readLedger } from './chunk-WWBF4Y7K.js';
 import { DEFAULT_CONFIG } from './chunk-NMZ3RHWW.js';
 import { print, theme, section, renderFleetRows, renderFleetNotes, renderFindings, TIER_BADGE, glyph } from './chunk-TADKOW6P.js';
-import { scanProject } from './chunk-SXCR6RRM.js';
-import './chunk-QYHROOMK.js';
+import { scanProject } from './chunk-RH2UAS25.js';
+import './chunk-KIMFKLJB.js';
 import { ETYMD_DIR } from './chunk-R74SJ7HS.js';
-import './chunk-HGSLHNNT.js';
+import './chunk-IGHES6AK.js';
 import { readText, pathExists, git, isDirectory } from './chunk-YLNQQZ5F.js';
 import { promises } from 'node:fs';
 import path from 'node:path';
@@ -687,8 +687,8 @@ async function checkCorpEmails(manifest, findings, disclosures) {
   }
 }
 async function checkGateDrift(manifest, findings, disclosures) {
-  const { planWorkflow } = await import('./generate-JEREMVVO.js');
-  const { scanProject: scanProject2 } = await import('./scan-O3SM2ODH.js');
+  const { planWorkflow } = await import('./generate-CBMTNN7P.js');
+  const { scanProject: scanProject2 } = await import('./scan-XZH57E4I.js');
   const { readConfig } = await import('./config-MX7OYI7F.js');
   for (const entry of manifest.entries) {
     const root = entry.resolvedRoot;

package/dist/{gates-IJNAQ7DC.js → gates-LTM5PE7R.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { applyFiles } from './chunk-EF6BPBG6.js';
-import { derivedCommands, planWorkflow, runPrefix, isSafeGateCommand } from './chunk-JTHZVEON.js';
+import { derivedCommands, planWorkflow, runPrefix, isSafeGateCommand } from './chunk-OX3LUOZR.js';
 import { readConfig, CONFIG_FILE, configPath } from './chunk-NMZ3RHWW.js';
 import { section, print, glyph, theme, renderPlan } from './chunk-TADKOW6P.js';
-import { scanProject } from './chunk-SXCR6RRM.js';
-import './chunk-QYHROOMK.js';
+import { scanProject } from './chunk-RH2UAS25.js';
+import './chunk-KIMFKLJB.js';
 import './chunk-R74SJ7HS.js';
-import './chunk-HGSLHNNT.js';
+import './chunk-IGHES6AK.js';
 import { readText, git } from './chunk-YLNQQZ5F.js';
 import { promises } from 'node:fs';
 import path from 'node:path';

package/dist/{generate-JEREMVVO.js → generate-CBMTNN7P.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-export { derivedCommands, planWorkflow } from './chunk-JTHZVEON.js';
+export { derivedCommands, planWorkflow } from './chunk-OX3LUOZR.js';
 import './chunk-NMZ3RHWW.js';
 import './chunk-R74SJ7HS.js';
-import './chunk-HGSLHNNT.js';
+import './chunk-IGHES6AK.js';
 import './chunk-YLNQQZ5F.js';

package/dist/index.d.ts

@@ -769,7 +769,7 @@ declare const gateIntegrityLens: Lens;
  * change meaning. Stamped into facts, baselines, and generated artifacts so drift against the
  * pack is computable and `harvest` has something to diff.
  */
-declare const PACK_VERSION = "4";
+declare const PACK_VERSION = "5";
 
 declare const VERSION: string;
 declare const NAME: string;

package/dist/index.js

@@ -19,7 +19,7 @@ var __export = (target, all) => {
 var PACK_VERSION;
 var init_version = __esm({
   "src/pack/version.ts"() {
-    PACK_VERSION = "4";
+    PACK_VERSION = "5";
   }
 });
 
@@ -29,7 +29,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "etymd",
-      version: "0.4.0",
+      version: "0.4.1",
       description: "Keep your agent instructions true \u2014 verify AGENTS.md, CLAUDE.md, rules & skills against the actual repo, with drift caught over time and a regression ledger.",
       keywords: [
         "cli",
@@ -1158,6 +1158,14 @@ if command -v shellcheck >/dev/null 2>&1; then
       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=$(printf '%s\\n' "$scripts" | xargs shellcheck -S style -f gcc 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
 else
   echo "\u203A shellcheck skipped (not on PATH) \u2014 install it to gate this repo's shell scripts"

package/dist/{init-BYZJOCS6.js → init-7GNB74BE.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { applyFiles } from './chunk-EF6BPBG6.js';
-import { planWorkflow } from './chunk-JTHZVEON.js';
+import { planWorkflow } from './chunk-OX3LUOZR.js';
 import './chunk-NMZ3RHWW.js';
 import { theme, renderFacts, print, renderPlan, section, glyph } from './chunk-TADKOW6P.js';
-import { scanProject } from './chunk-SXCR6RRM.js';
-import { VERSION } from './chunk-QYHROOMK.js';
+import { scanProject } from './chunk-RH2UAS25.js';
+import { VERSION } from './chunk-KIMFKLJB.js';
 import { writeCachedFacts, deriveProfile, writeBaseline, CACHE_DIR } from './chunk-R74SJ7HS.js';
-import { PACK_VERSION } from './chunk-HGSLHNNT.js';
+import { PACK_VERSION } from './chunk-IGHES6AK.js';
 import { git, readText } from './chunk-YLNQQZ5F.js';
 import { promises } from 'node:fs';
 import path from 'node:path';

package/dist/{scan-DPEOA3KZ.js → scan-6YOKI3JW.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { print, renderFacts, theme } from './chunk-TADKOW6P.js';
-import { scanProject } from './chunk-SXCR6RRM.js';
-import './chunk-QYHROOMK.js';
+import { scanProject } from './chunk-RH2UAS25.js';
+import './chunk-KIMFKLJB.js';
 import { writeCachedFacts } from './chunk-R74SJ7HS.js';
-import './chunk-HGSLHNNT.js';
+import './chunk-IGHES6AK.js';
 import './chunk-YLNQQZ5F.js';
 
 // src/commands/scan.ts

package/dist/scan-XZH57E4I.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+export { scanProject } from './chunk-RH2UAS25.js';
+import './chunk-KIMFKLJB.js';
+import './chunk-IGHES6AK.js';
+import './chunk-YLNQQZ5F.js';

package/package.json

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

package/dist/scan-O3SM2ODH.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-export { scanProject } from './chunk-SXCR6RRM.js';
-import './chunk-QYHROOMK.js';
-import './chunk-HGSLHNNT.js';
-import './chunk-YLNQQZ5F.js';