etymd 0.17.0 → 0.19.1

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { VERSION } from './chunk-BUMOGHQA.js';
+import { VERSION } from './chunk-KQFEKOON.js';
 import path from '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-PHAK5HEW.js');
+    const { run } = await import('./audit-5N2TU2X7.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 asked").option("-y, --yes", "accept defaults without prompting (never overwrites)").option("--with-agents", "also scaffold a minimal AGENTS.md where none exists (off by default)").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./init-6RULX5JZ.js');
+    const { run } = await import('./init-G4XXFXVD.js');
     await run({ cwd: resolveCwd(cmd), yes: opts.yes, withAgents: opts.withAgents });
   })
 );
@@ -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-VN4EDBR5.js');
+    const { run } = await import('./approve-J6JU7MBX.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-LLWW4YOU.js');
+    const { run } = await import('./scan-PJH32H7C.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-R4QDCAN5.js');
+    const { run } = await import('./doctor-264Q5PLY.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-7MWP35UI.js');
+    const { run } = await import('./brief-NHHILXIH.js');
     await run({ cwd: resolveCwd(cmd), human: opts.human });
   })
 );
@@ -90,7 +90,7 @@ program.command("premise").argument("[task]", "the task you are about to hand an
   "exit non-zero when findings at/above this tier exist (risk|gap|polish)"
 ).action(
   (task, opts, cmd) => action(async () => {
-    const { run } = await import('./premise-GFWHSR3K.js');
+    const { run } = await import('./premise-RNMAKMVA.js');
     await run({
       cwd: resolveCwd(cmd),
       task,
@@ -132,7 +132,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-WPYEVHVL.js');
+    const { sweep } = await import('./fleet-VT625Q2J.js');
     await sweep({
       cwd: resolveCwd(cmd),
       manifest: opts.manifest,
@@ -147,7 +147,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-WPYEVHVL.js');
+    const { check } = await import('./fleet-VT625Q2J.js');
     const opts = cmd.optsWithGlobals();
     await check({ cwd: resolveCwd(cmd), manifest: opts.manifest, json: opts.json });
   })
@@ -156,7 +156,7 @@ fleet.command("board").description(
   "Render the fleet board: every project's milestones (contract key `milestones`) plus a ranked initiatives table"
 ).option("--manifest <file>", "the fleet manifest \u2014 required unless the cwd holds registry.json").option("--initiatives <file>", "the hand-edited initiatives table (rank | id | initiative | \u2026)").option("--out <file>", "write the Markdown board here instead of printing it").option("--json", "print the board as JSON (EXPERIMENTAL)").action(
   (opts, cmd) => action(async () => {
-    const { board } = await import('./fleet-WPYEVHVL.js');
+    const { board } = await import('./fleet-VT625Q2J.js');
     const shared = cmd.optsWithGlobals();
     await board({
       cwd: resolveCwd(cmd),
@@ -172,7 +172,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-WPYEVHVL.js');
+    const { add } = await import('./fleet-VT625Q2J.js');
     const shared = cmd.optsWithGlobals();
     await add({
       cwd: resolveCwd(cmd),
@@ -195,7 +195,7 @@ fleet.command("dismiss").argument("<name>", "the registered project name").argum
   "Dismiss a project's finding from any cwd \u2014 guarded 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-WPYEVHVL.js');
+    const { dismiss } = await import('./fleet-VT625Q2J.js');
     const opts = cmd.optsWithGlobals();
     await dismiss({
       cwd: resolveCwd(cmd),
@@ -210,7 +210,7 @@ fleet.command("accept").argument("<name>", "the registered project name").argume
   "Accept a project's finding as a known trade-off \u2014 guarded 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-WPYEVHVL.js');
+    const { accept } = await import('./fleet-VT625Q2J.js');
     const opts = cmd.optsWithGlobals();
     await accept({ cwd: resolveCwd(cmd), manifest: opts.manifest, name, id, reason: opts.reason });
   })
@@ -225,7 +225,7 @@ program.command("propose").description(
   "the fleet manifest \u2014 runs a read-only sweep now (no delta baseline move)"
 ).option("--from <file>", "read a stored `etymd fleet --json` output instead of sweeping").option("--json", "print the proposal/1 records as JSON (EXPERIMENTAL)").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./propose-IYNOIWAO.js');
+    const { run } = await import('./propose-35JXMEPH.js');
     await run({
       cwd: resolveCwd(cmd),
       manifest: opts.manifest,
@@ -256,7 +256,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-3HRGYCYY.js');
+    const { run } = await import('./gates-YUMSTKUG.js');
     await run({ cwd: resolveCwd(cmd), ci: opts.ci, yes: opts.yes });
   })
 );

package/dist/{doctor-R4QDCAN5.js → doctor-264Q5PLY.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-import { run } from './chunk-ANFNXFRI.js';
-import './chunk-WKP7M2B3.js';
-import './chunk-FNA4R5KT.js';
+import { run } from './chunk-GFUDKTC5.js';
+import './chunk-UMKC3OWQ.js';
+import './chunk-WKP72Z3J.js';
 import './chunk-3E2IPCRY.js';
 import './chunk-HI7NWPRA.js';
-import './chunk-446EZNAQ.js';
-import './chunk-BUMOGHQA.js';
+import './chunk-6DJMKZGK.js';
+import './chunk-KQFEKOON.js';
 import './chunk-P6ATKV2R.js';
-import './chunk-YQZDYDAK.js';
+import './chunk-2DRA7S67.js';
 import './chunk-4VPBP6K6.js';
 
 // src/commands/doctor.ts

package/dist/{fleet-WPYEVHVL.js → fleet-VT625Q2J.js}

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
 import { dismiss, accept } from './chunk-HOR4M6EC.js';
-import { sweepFleet, FLEET_JSON_SCHEMA, checkManifest, FLEET_TRUST_VALUES, isFleetTrust, MILESTONES_FILE, parseMilestones, parseInitiatives, BOARD_JSON_SCHEMA, renderBoard, loadFleetManifest, fleetLedgerTarget, ensureFindingRecorded } from './chunk-LVR2DPR7.js';
-import './chunk-WKP7M2B3.js';
-import { parseFailOnTier, meetsFailOn } from './chunk-FNA4R5KT.js';
+import { sweepFleet, FLEET_JSON_SCHEMA, checkManifest, FLEET_TRUST_VALUES, isFleetTrust, MILESTONES_FILE, parseMilestones, parseInitiatives, BOARD_JSON_SCHEMA, renderBoard, loadFleetManifest, fleetLedgerTarget, ensureFindingRecorded } from './chunk-M7XDP6FT.js';
+import './chunk-UMKC3OWQ.js';
+import { parseFailOnTier, meetsFailOn } from './chunk-WKP72Z3J.js';
 import './chunk-3E2IPCRY.js';
+import { generateClaudePointerMd } from './chunk-PQISPOB2.js';
 import { print, theme, section, renderFleetRows, renderFleetNotes, renderFindings, TIER_BADGE, glyph } from './chunk-HI7NWPRA.js';
-import { scanProject } from './chunk-446EZNAQ.js';
-import './chunk-BUMOGHQA.js';
+import { checkClaudePointer, scanProject } from './chunk-6DJMKZGK.js';
+import './chunk-KQFEKOON.js';
 import './chunk-P6ATKV2R.js';
-import './chunk-YQZDYDAK.js';
+import './chunk-2DRA7S67.js';
 import { readText, pathExists, git } from './chunk-4VPBP6K6.js';
 import { promises } from 'fs';
 import os from 'os';
@@ -234,6 +235,21 @@ async function add(opts) {
   if (manifest.entries.some((e) => e.name === name)) {
     throw new Error(`\`${name}\` is already registered \u2014 resolution is keyed by name`);
   }
+  const pointer = await checkClaudePointer(absTarget);
+  if (!pointer.ok && pointer.kind === "no-import") {
+    throw new Error(
+      `\`${name}\` has a CLAUDE.md that hides its AGENTS.md from Claude Code (${pointer.detail}). Add a full-line \`@AGENTS.md\` import to it, e.g.:
+
+${generateClaudePointerMd().trimEnd().split("\n").join("\n")}
+
+\u2014 or symlink either file to the other, or delete the CLAUDE.md \u2014 then re-run \`etymd fleet add\`.`
+    );
+  }
+  if (!pointer.ok) {
+    print(
+      `  ${theme.warn("note")} ${pointer.detail}. Update Claude Code, or add a CLAUDE.md containing \`@AGENTS.md\`.`
+    );
+  }
   const facts = await scanProject(absTarget);
   const remote = facts.git.isRepo ? await git(absTarget, ["remote", "get-url", "origin"]) : null;
   section(`Fleet add ${theme.dim(`\xB7 ${name} \xB7 ${absTarget}`)}`);

package/dist/{gates-3HRGYCYY.js → gates-YUMSTKUG.js}

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { applyFiles } from './chunk-GWGKEPRX.js';
-import { deriveFailOn, derivedCommands, planWorkflow, runPrefix, isSafeGateCommand } from './chunk-PIJZUDDQ.js';
+import { deriveFailOn, derivedCommands, planWorkflow } from './chunk-7N5JDXQG.js';
+import { runPrefix, isSafeGateCommand } from './chunk-PQISPOB2.js';
 import { section, print, glyph, theme, renderPlan } from './chunk-HI7NWPRA.js';
-import { scanProject } from './chunk-446EZNAQ.js';
-import './chunk-BUMOGHQA.js';
+import { scanProject } from './chunk-6DJMKZGK.js';
+import './chunk-KQFEKOON.js';
 import { readConfig, CONFIG_FILE, configPath } from './chunk-P6ATKV2R.js';
-import './chunk-YQZDYDAK.js';
+import './chunk-2DRA7S67.js';
 import { readText, git } from './chunk-4VPBP6K6.js';
 import { promises } from 'fs';
 import path from 'path';

package/dist/{generate-FSJQFQPV.js → generate-62GQSCKH.js}

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-export { deriveFailOn, derivedCommands, planWorkflow, riskReachability } from './chunk-PIJZUDDQ.js';
+export { deriveFailOn, derivedCommands, planWorkflow, riskReachability } from './chunk-7N5JDXQG.js';
+import './chunk-PQISPOB2.js';
 import './chunk-P6ATKV2R.js';
-import './chunk-YQZDYDAK.js';
+import './chunk-2DRA7S67.js';
 import './chunk-4VPBP6K6.js';

package/dist/index.d.ts

@@ -66,6 +66,11 @@ interface GitFacts {
     isRepo: boolean;
     branch?: string;
     head?: string;
+    /**
+     * `core.hooksPath`, stated repo-relative whenever the directory sits inside the worktree — git
+     * accepts an absolute spelling of the same directory, and the spelling is neither a fact nor
+     * something a committed baseline should carry. Absolute only when it points outside the repo.
+     */
     hooksPath?: string;
     husky: boolean;
     /** Distinct commit authors in recent history — the solo-vs-team profile signal. */
@@ -793,8 +798,12 @@ interface TruthEnv {
     manifestExists: boolean;
     /** The root plus every workspace package dir — where claims are resolved. */
     bases: string[];
-    /** A repo-relative claim resolves in the root, any workspace package, or their src/ scripts/. */
-    pathResolves(claim: string): Promise<boolean>;
+    /**
+     * A repo-relative claim resolves in the root, any workspace package, their src/ scripts/, or
+     * the directory of the file making the claim (`fromDir`) — a nested instruction file writes
+     * references the way an agent reading it resolves them: against its siblings.
+     */
+    pathResolves(claim: string, fromDir?: string): Promise<boolean>;
     /** `yarn X` / `pnpm X` may legitimately run an installed node_modules/.bin binary. */
     binResolves(name: string): Promise<boolean>;
 }
@@ -807,6 +816,8 @@ interface ClaimCounters {
     unverifiableCommands: number;
     gitignoredSkipped: number;
     prospectiveSkipped: number;
+    /** Path claims whose every mention sits beside the URL it is fetched from — another tree. */
+    fetchedSkipped: number;
     placeholderSkipped: number;
     /** Decision references naming another record (a fleet-level ledger) — not this repo's. */
     qualifiedRefsSkipped: number;
@@ -995,8 +1006,15 @@ declare function extractCommandClaims(text: string): CommandClaims;
 interface PathClaims {
     /** Claims to verify against the repo. */
     paths: string[];
+    /** Slash-terminated directory claims — candidate bases for resolving sibling references. */
+    dirs: string[];
     /** Claims whose every mention sits in create-this prose — skipped, counted, disclosed. */
     prospective: string[];
+    /**
+     * Claims whose every mention sits beside the URL they are fetched from — another tree's
+     * files, unverifiable here. Skipped, counted, disclosed.
+     */
+    fetched: string[];
     /** Claims whose every mention sits behind a namespace prefix (`pc:`) — another repo's tree. */
     namespaced: string[];
     /** Naming stand-ins (`my-custom-skill`) — never real claims. */
@@ -1109,7 +1127,7 @@ declare const gateIntegrityLens: Lens;
  * Gaps in the sequence are deliberate: a number stays retired even when the change that took it
  * never shipped, so a version cited in a baseline or a record means exactly one pack, ever.
  */
-declare const PACK_VERSION = "12";
+declare const PACK_VERSION = "15";
 
 declare const VERSION: string;
 declare const NAME: string;