etymd 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # etymd
 
+## 0.7.0
+
+### Minor Changes
+
+- 7371c8b: Decisions records can require fields of their own, and etymd holds no opinion about which.
+
+  A decisions file already opts into per-entry format checks with a marker. It can now append field
+  names to it — `<!-- decisions-format: 1 fields=Owner,Rollback -->` — and every entry after the
+  marker must carry each one. `Owner:` and `**Owner:**` both count. Decision record:
+  [`docs/decisions/007-declared-entry-fields.md`](docs/decisions/007-declared-entry-fields.md).
+
+  **The tool ships the shape, not the vocabulary.** Etymd never interprets a declared name and has no
+  list of fields it thinks a record ought to have; it verifies that a line introducing the name
+  exists, and that is all. Which fields are worth requiring is the file's position to take, not the
+  tool's — a name coined for one project's process is exactly the kind of opinion this package does
+  not ship, however cleanly it would mechanize.
+
+  **Nothing is dropped in silence.** A name that cannot be used as a field, a marker version this
+  build does not know, and a redeclared `Scope` are each disclosed in the lens report. A file that
+  believes it declared a requirement, and is quietly audited without it, would come back clean for
+  the one reason this tool exists to reject — so the failure is stated rather than absorbed.
+  Declarable names are letters, digits, spaces, `-` and `_`, which keeps regex metacharacters out of
+  the matcher by construction.
+
+  **Enforcement is every-entry, with no keyword trigger.** Requiring the fields only on entries whose
+  prose looks like it is claiming something would flag an entry that mentions a closed tab or a fixed
+  price, and a false "your file is lying" costs more trust than a missed one. Every entry after the
+  marker is held to the same rule, which is what `Scope:` already does and takes one sentence to
+  explain.
+
+  **Existing files are unaffected.** `fields=` is an extension rather than a new format version: a
+  marker without it behaves exactly as before, pre-marker entries stay untouched, and a repo that
+  declares nothing sees no change. The declaration lives on the marker rather than in
+  `.etymd/config.json` so the requirement sits beside the entries it governs, which also lets a repo
+  keep two decision records with different obligations.
+
 ## 0.6.0
 
 ### Minor Changes

package/README.md

@@ -147,7 +147,11 @@ _relative_ — a state doc is stale only when the repo moved past it, so a dorma
 state is current; a tracked file with uncommitted edits is treated fresh-now (the refresh is
 already on disk) and disclosed. Decisions records get format checks (`Scope:` presence, a
 `Revisit:` date that, once past, becomes a finding) — opt in by adding the literal marker
-`<!-- decisions-format: 1 -->` anywhere in the file; forward-only, never retroactive. Duplicate
+`<!-- decisions-format: 1 -->` anywhere in the file; forward-only, never retroactive. A file can
+require field names of its own by appending them to the marker —
+`<!-- decisions-format: 1 fields=Owner,Rollback -->` — and each is then checked on every entry.
+Etymd ships no field vocabulary and reads no meaning into the names; it verifies only that what
+the file declared is present, and discloses any name it could not use. Duplicate
 or out-of-order `D-NNN` ids are flagged with a rename action even without the marker — an
 append race is a defect in the file's own convention, not a format opinion.
 

package/dist/{approve-ZLOW4A7R.js → approve-TXF3MA3G.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { section, theme, print, renderBaselineDrift, glyph } from './chunk-5BVKFJWM.js';
-import { scanProject } from './chunk-ULEWJ3ZK.js';
-import { VERSION } from './chunk-HLWCODYX.js';
+import { scanProject } from './chunk-XJMN2HMH.js';
+import { VERSION } from './chunk-OGIHOTLP.js';
 import { readBaseline, summarizeBaselineDrift, isDriftEmpty, writeBaseline, deriveProfile } from './chunk-C7LBUFNU.js';
 import { PACK_VERSION } from './chunk-6DUDIVIC.js';
 import './chunk-IV3FYVTS.js';

package/dist/{audit-ICT2JK7A.js → audit-354X7QN6.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-export { run } from './chunk-BQGCLPHS.js';
-import './chunk-OESQNO2J.js';
+export { run } from './chunk-7LVCGCHB.js';
+import './chunk-LXEYYITD.js';
 import './chunk-OKU3HXIH.js';
 import './chunk-OAFYLBVG.js';
 import './chunk-K7QBTANO.js';
 import './chunk-5BVKFJWM.js';
-import './chunk-ULEWJ3ZK.js';
-import './chunk-HLWCODYX.js';
+import './chunk-XJMN2HMH.js';
+import './chunk-OGIHOTLP.js';
 import './chunk-C7LBUFNU.js';
 import './chunk-6DUDIVIC.js';
 import './chunk-IV3FYVTS.js';

package/dist/{brief-PDUGGMLI.js → brief-QUYHRWH6.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { print, theme } from './chunk-5BVKFJWM.js';
-import { scanProject } from './chunk-ULEWJ3ZK.js';
-import './chunk-HLWCODYX.js';
+import { scanProject } from './chunk-XJMN2HMH.js';
+import './chunk-OGIHOTLP.js';
 import { ETYMD_DIR } from './chunk-C7LBUFNU.js';
 import './chunk-6DUDIVIC.js';
 import './chunk-IV3FYVTS.js';

package/dist/{chunk-BQGCLPHS.js → chunk-7LVCGCHB.js}

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

package/dist/{chunk-OESQNO2J.js → chunk-LXEYYITD.js}

@@ -2,7 +2,7 @@
 import { measureContext } from './chunk-OKU3HXIH.js';
 import { readLedger, reconcileLedger, writeLedger, visibleFindings } from './chunk-OAFYLBVG.js';
 import { DEFAULT_CONFIG, readConfig, CONFIG_FILE } from './chunk-K7QBTANO.js';
-import { scanProject, expandFileGlobs } from './chunk-ULEWJ3ZK.js';
+import { scanProject, expandFileGlobs } from './chunk-XJMN2HMH.js';
 import { ETYMD_DIR, writeCachedFacts, readBaseline, deriveProfile, baselineCarriesMachinePath, BASELINE_FILE } from './chunk-C7LBUFNU.js';
 import { PACK_VERSION } from './chunk-6DUDIVIC.js';
 import { pathExists, readJson, git, readText, isDirectory, matchesAnyGlob, isCiEnvironment, normalizeRelPath, isExecutable } from './chunk-IV3FYVTS.js';
@@ -1177,7 +1177,52 @@ var instructionTruthLens = {
 };
 var LENS_ID4 = "state-freshness";
 var DECISIONS_FORMAT_MARKER = "<!-- decisions-format: 1 -->";
+var KNOWN_FORMAT_VERSION = 1;
+var MARKER_RE = /<!--\s*decisions-format:\s*(\d+)([^>]*?)-->/;
+var FIELD_NAME_RE = /^[A-Za-z0-9 _-]+$/;
+var BUILT_IN_FIELDS = /* @__PURE__ */ new Set(["scope"]);
 var MS_PER_DAY = 864e5;
+function parseDecisionsFormat(text) {
+  const m = MARKER_RE.exec(text);
+  if (!m) return null;
+  const problems = [];
+  const fields = [];
+  const version = Number(m[1]);
+  if (version !== KNOWN_FORMAT_VERSION) {
+    problems.push(
+      `declares decisions-format version ${version}; this etymd understands version ${KNOWN_FORMAT_VERSION} \u2014 checked as version ${KNOWN_FORMAT_VERSION}.`
+    );
+  }
+  const attrs = (m[2] ?? "").trim();
+  if (!attrs) return { fields, problems };
+  const declared = /^fields=(.*)$/.exec(attrs);
+  if (!declared) {
+    problems.push(`marker attribute \`${attrs}\` is not understood \u2014 ignored (only \`fields=\`).`);
+    return { fields, problems };
+  }
+  const seen = new Set(BUILT_IN_FIELDS);
+  for (const raw of declared[1].split(",")) {
+    const name = raw.trim();
+    if (!name) continue;
+    if (!FIELD_NAME_RE.test(name)) {
+      problems.push(
+        `declared field \`${name}\` is not a usable field name (letters, digits, spaces, \`-\`, \`_\`) \u2014 not checked.`
+      );
+      continue;
+    }
+    const key = name.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    fields.push(name);
+  }
+  if (fields.length === 0 && problems.length === 0) {
+    problems.push("marker declares `fields=` with no field names \u2014 no extra fields checked.");
+  }
+  return { fields, problems };
+}
+function hasField(block, name) {
+  return new RegExp(`${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s*]*:`).test(block);
+}
 function parseDecisionEntries(text) {
   const headings = [...text.matchAll(/^## .*$/gm)];
   const entries = [];
@@ -1233,9 +1278,23 @@ function checkIdSequence(file, entries) {
   }
   return findings;
 }
-function checkFormatFields(file, entries, today) {
+function checkFormatFields(file, entries, today, declaredFields) {
   const findings = [];
   for (const entry of entries) {
+    for (const field of declaredFields) {
+      if (hasField(entry.block, field)) continue;
+      findings.push({
+        id: `${LENS_ID4}/field-missing:${file}:${entry.id}:${field}`,
+        lens: LENS_ID4,
+        tier: "gap",
+        claim: `${file} ${entry.id} has no ${field}: field`,
+        evidence: [`${file}: ${entry.id}`, `${file} marker declares required field \`${field}\``],
+        why: "The file declares this field required on every entry after the marker; whatever reads the record for it finds nothing here.",
+        action: `Add a ${field}: line to ${entry.id}.`,
+        effort: "S",
+        confidence: "high"
+      });
+    }
     if (!/Scope[\s*]*:/.test(entry.block)) {
       findings.push({
         id: `${LENS_ID4}/scope-missing:${file}:${entry.id}`,
@@ -1351,14 +1410,21 @@ var stateFreshnessLens = {
       }
       const entries = parseDecisionEntries(text);
       findings.push(...checkIdSequence(a.path, entries));
-      if (!text.includes(DECISIONS_FORMAT_MARKER)) {
+      const format = parseDecisionsFormat(text);
+      if (!format) {
         disclosures.push(
           `${a.path} carries no \`${DECISIONS_FORMAT_MARKER}\` marker \u2014 format checks skipped (forward-only, never retroactive); id-sequence checks still ran.`
         );
         outOfScope.push(a.path);
         continue;
       }
-      findings.push(...checkFormatFields(a.path, entries, today));
+      for (const problem of format.problems) disclosures.push(`${a.path}: ${problem}`);
+      if (format.fields.length > 0) {
+        disclosures.push(
+          `${a.path} declares required entry fields: ${format.fields.join(", ")} \u2014 checked on every entry (etymd attaches no meaning to the names).`
+        );
+      }
+      findings.push(...checkFormatFields(a.path, entries, today, format.fields));
     }
     disclosures.push(
       `Thresholds: staleAfterDays ${budgets.staleAfterDays} (3x escalates to risk), state budget ${budgets.maxChars} chars (${budgets.staleAfterDays === DEFAULT_CONFIG.state.staleAfterDays && budgets.maxChars === DEFAULT_CONFIG.state.maxChars ? `defaults \u2014 override under \`state\` in ${CONFIG_FILE}` : `set in ${CONFIG_FILE}`}). Decisions artifacts are exempt from age \u2014 old decisions are history, not defects.`

package/dist/{chunk-HLWCODYX.js → chunk-OGIHOTLP.js}

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

package/dist/{chunk-ULEWJ3ZK.js → chunk-XJMN2HMH.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { VERSION } from './chunk-HLWCODYX.js';
+import { VERSION } from './chunk-OGIHOTLP.js';
 import { PACK_VERSION } from './chunk-6DUDIVIC.js';
 import { normalizeRelPath, isDirectory, readJson, git, matchesAnyGlob, pathExists, readText } from './chunk-IV3FYVTS.js';
 import path from 'node:path';

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { VERSION } from './chunk-HLWCODYX.js';
+import { VERSION } from './chunk-OGIHOTLP.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-ICT2JK7A.js');
+    const { run } = await import('./audit-354X7QN6.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-IPUPP4GB.js');
+    const { run } = await import('./init-52PR24Q4.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-ZLOW4A7R.js');
+    const { run } = await import('./approve-TXF3MA3G.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-6L4L2GXT.js');
+    const { run } = await import('./scan-GSDICQCX.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-PORXFSYT.js');
+    const { run } = await import('./doctor-2BU6WCI6.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-PDUGGMLI.js');
+    const { run } = await import('./brief-QUYHRWH6.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-JHNQOLSY.js');
+    const { sweep } = await import('./fleet-3UQ65X4Y.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-JHNQOLSY.js');
+    const { check } = await import('./fleet-3UQ65X4Y.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-JHNQOLSY.js');
+    const { add } = await import('./fleet-3UQ65X4Y.js');
     const shared = cmd.optsWithGlobals();
     await add({
       cwd: resolveCwd(cmd),
@@ -159,7 +159,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-JHNQOLSY.js');
+    const { dismiss } = await import('./fleet-3UQ65X4Y.js');
     const opts = cmd.optsWithGlobals();
     await dismiss({
       cwd: resolveCwd(cmd),
@@ -174,7 +174,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-JHNQOLSY.js');
+    const { accept } = await import('./fleet-3UQ65X4Y.js');
     const opts = cmd.optsWithGlobals();
     await accept({ cwd: resolveCwd(cmd), manifest: opts.manifest, name, id, reason: opts.reason });
   })
@@ -196,7 +196,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-KHC7HPIF.js');
+    const { run } = await import('./gates-MYNOZCON.js');
     await run({ cwd: resolveCwd(cmd), ci: opts.ci, yes: opts.yes });
   })
 );

package/dist/{doctor-PORXFSYT.js → doctor-2BU6WCI6.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { run } from './chunk-BQGCLPHS.js';
-import './chunk-OESQNO2J.js';
+import { run } from './chunk-7LVCGCHB.js';
+import './chunk-LXEYYITD.js';
 import './chunk-OKU3HXIH.js';
 import './chunk-OAFYLBVG.js';
 import './chunk-K7QBTANO.js';
 import './chunk-5BVKFJWM.js';
-import './chunk-ULEWJ3ZK.js';
-import './chunk-HLWCODYX.js';
+import './chunk-XJMN2HMH.js';
+import './chunk-OGIHOTLP.js';
 import './chunk-C7LBUFNU.js';
 import './chunk-6DUDIVIC.js';
 import './chunk-IV3FYVTS.js';

package/dist/{fleet-JHNQOLSY.js → fleet-3UQ65X4Y.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { dismiss, accept } from './chunk-V2SOHPXF.js';
-import { parseFailOnTier, meetsFailOn, runAudit } from './chunk-OESQNO2J.js';
+import { parseFailOnTier, meetsFailOn, runAudit } from './chunk-LXEYYITD.js';
 import './chunk-OKU3HXIH.js';
 import { readLedger } from './chunk-OAFYLBVG.js';
 import { DEFAULT_CONFIG } from './chunk-K7QBTANO.js';
 import { print, theme, section, renderFleetRows, renderFleetNotes, renderFindings, TIER_BADGE, glyph } from './chunk-5BVKFJWM.js';
-import { scanProject } from './chunk-ULEWJ3ZK.js';
-import './chunk-HLWCODYX.js';
+import { scanProject } from './chunk-XJMN2HMH.js';
+import './chunk-OGIHOTLP.js';
 import { ETYMD_DIR } from './chunk-C7LBUFNU.js';
 import './chunk-6DUDIVIC.js';
 import { readText, pathExists, git, isDirectory } from './chunk-IV3FYVTS.js';
@@ -688,7 +688,7 @@ async function checkCorpEmails(manifest, findings, disclosures) {
 }
 async function checkGateDrift(manifest, findings, disclosures) {
   const { planWorkflow } = await import('./generate-UTKQ4GE6.js');
-  const { scanProject: scanProject2 } = await import('./scan-D4M7JXE3.js');
+  const { scanProject: scanProject2 } = await import('./scan-M6RKDNYR.js');
   const { readConfig } = await import('./config-UJRSCDMD.js');
   for (const entry of manifest.entries) {
     const root = entry.resolvedRoot;

package/dist/{gates-KHC7HPIF.js → gates-MYNOZCON.js}

@@ -3,8 +3,8 @@ import { applyFiles } from './chunk-EF6BPBG6.js';
 import { derivedCommands, planWorkflow, runPrefix, isSafeGateCommand } from './chunk-KTIEYKFK.js';
 import { readConfig, CONFIG_FILE, configPath } from './chunk-K7QBTANO.js';
 import { section, print, glyph, theme, renderPlan } from './chunk-5BVKFJWM.js';
-import { scanProject } from './chunk-ULEWJ3ZK.js';
-import './chunk-HLWCODYX.js';
+import { scanProject } from './chunk-XJMN2HMH.js';
+import './chunk-OGIHOTLP.js';
 import './chunk-C7LBUFNU.js';
 import './chunk-6DUDIVIC.js';
 import { readText, git } from './chunk-IV3FYVTS.js';

package/dist/index.d.ts

@@ -721,6 +721,11 @@ declare const contextEconomyLens: Lens;
  * The marker that opts a decisions file into per-entry format checks. Forward-only by design:
  * mandatory-field checks apply to files that declared the format, never retroactively to
  * pre-existing records — old decisions are history, not defects.
+ *
+ * A file may append `fields=A,B` to require field names of its own choosing on every entry.
+ * Etymd ships no vocabulary for those names and attaches no meaning to them: it checks only that
+ * a field the file itself declared is present. A marker with no `fields=` behaves as it always
+ * has, so the attribute is an extension rather than a new format version.
  */
 declare const DECISIONS_FORMAT_MARKER = "<!-- decisions-format: 1 -->";
 /**

package/dist/index.js

@@ -30,7 +30,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "etymd",
-      version: "0.6.0",
+      version: "0.7.0",
       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",
@@ -2617,7 +2617,52 @@ init_config();
 init_util();
 var LENS_ID4 = "state-freshness";
 var DECISIONS_FORMAT_MARKER = "<!-- decisions-format: 1 -->";
+var KNOWN_FORMAT_VERSION = 1;
+var MARKER_RE = /<!--\s*decisions-format:\s*(\d+)([^>]*?)-->/;
+var FIELD_NAME_RE = /^[A-Za-z0-9 _-]+$/;
+var BUILT_IN_FIELDS = /* @__PURE__ */ new Set(["scope"]);
 var MS_PER_DAY = 864e5;
+function parseDecisionsFormat(text) {
+  const m = MARKER_RE.exec(text);
+  if (!m) return null;
+  const problems = [];
+  const fields = [];
+  const version = Number(m[1]);
+  if (version !== KNOWN_FORMAT_VERSION) {
+    problems.push(
+      `declares decisions-format version ${version}; this etymd understands version ${KNOWN_FORMAT_VERSION} \u2014 checked as version ${KNOWN_FORMAT_VERSION}.`
+    );
+  }
+  const attrs = (m[2] ?? "").trim();
+  if (!attrs) return { fields, problems };
+  const declared = /^fields=(.*)$/.exec(attrs);
+  if (!declared) {
+    problems.push(`marker attribute \`${attrs}\` is not understood \u2014 ignored (only \`fields=\`).`);
+    return { fields, problems };
+  }
+  const seen = new Set(BUILT_IN_FIELDS);
+  for (const raw of declared[1].split(",")) {
+    const name = raw.trim();
+    if (!name) continue;
+    if (!FIELD_NAME_RE.test(name)) {
+      problems.push(
+        `declared field \`${name}\` is not a usable field name (letters, digits, spaces, \`-\`, \`_\`) \u2014 not checked.`
+      );
+      continue;
+    }
+    const key = name.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    fields.push(name);
+  }
+  if (fields.length === 0 && problems.length === 0) {
+    problems.push("marker declares `fields=` with no field names \u2014 no extra fields checked.");
+  }
+  return { fields, problems };
+}
+function hasField(block, name) {
+  return new RegExp(`${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s*]*:`).test(block);
+}
 function parseDecisionEntries(text) {
   const headings = [...text.matchAll(/^## .*$/gm)];
   const entries = [];
@@ -2673,9 +2718,23 @@ function checkIdSequence(file, entries) {
   }
   return findings;
 }
-function checkFormatFields(file, entries, today) {
+function checkFormatFields(file, entries, today, declaredFields) {
   const findings = [];
   for (const entry of entries) {
+    for (const field of declaredFields) {
+      if (hasField(entry.block, field)) continue;
+      findings.push({
+        id: `${LENS_ID4}/field-missing:${file}:${entry.id}:${field}`,
+        lens: LENS_ID4,
+        tier: "gap",
+        claim: `${file} ${entry.id} has no ${field}: field`,
+        evidence: [`${file}: ${entry.id}`, `${file} marker declares required field \`${field}\``],
+        why: "The file declares this field required on every entry after the marker; whatever reads the record for it finds nothing here.",
+        action: `Add a ${field}: line to ${entry.id}.`,
+        effort: "S",
+        confidence: "high"
+      });
+    }
     if (!/Scope[\s*]*:/.test(entry.block)) {
       findings.push({
         id: `${LENS_ID4}/scope-missing:${file}:${entry.id}`,
@@ -2791,14 +2850,21 @@ var stateFreshnessLens = {
       }
       const entries = parseDecisionEntries(text);
       findings.push(...checkIdSequence(a.path, entries));
-      if (!text.includes(DECISIONS_FORMAT_MARKER)) {
+      const format = parseDecisionsFormat(text);
+      if (!format) {
         disclosures.push(
           `${a.path} carries no \`${DECISIONS_FORMAT_MARKER}\` marker \u2014 format checks skipped (forward-only, never retroactive); id-sequence checks still ran.`
         );
         outOfScope.push(a.path);
         continue;
       }
-      findings.push(...checkFormatFields(a.path, entries, today));
+      for (const problem of format.problems) disclosures.push(`${a.path}: ${problem}`);
+      if (format.fields.length > 0) {
+        disclosures.push(
+          `${a.path} declares required entry fields: ${format.fields.join(", ")} \u2014 checked on every entry (etymd attaches no meaning to the names).`
+        );
+      }
+      findings.push(...checkFormatFields(a.path, entries, today, format.fields));
     }
     disclosures.push(
       `Thresholds: staleAfterDays ${budgets.staleAfterDays} (3x escalates to risk), state budget ${budgets.maxChars} chars (${budgets.staleAfterDays === DEFAULT_CONFIG.state.staleAfterDays && budgets.maxChars === DEFAULT_CONFIG.state.maxChars ? `defaults \u2014 override under \`state\` in ${CONFIG_FILE}` : `set in ${CONFIG_FILE}`}). Decisions artifacts are exempt from age \u2014 old decisions are history, not defects.`

package/dist/{init-IPUPP4GB.js → init-52PR24Q4.js}

@@ -3,8 +3,8 @@ import { applyFiles } from './chunk-EF6BPBG6.js';
 import { planWorkflow } from './chunk-KTIEYKFK.js';
 import './chunk-K7QBTANO.js';
 import { theme, renderFacts, print, renderPlan, section, glyph } from './chunk-5BVKFJWM.js';
-import { scanProject } from './chunk-ULEWJ3ZK.js';
-import { VERSION } from './chunk-HLWCODYX.js';
+import { scanProject } from './chunk-XJMN2HMH.js';
+import { VERSION } from './chunk-OGIHOTLP.js';
 import { writeCachedFacts, deriveProfile, writeBaseline, CACHE_DIR } from './chunk-C7LBUFNU.js';
 import { PACK_VERSION } from './chunk-6DUDIVIC.js';
 import { git, readText } from './chunk-IV3FYVTS.js';

package/dist/{scan-6L4L2GXT.js → scan-GSDICQCX.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { print, renderFacts, theme } from './chunk-5BVKFJWM.js';
-import { scanProject } from './chunk-ULEWJ3ZK.js';
-import './chunk-HLWCODYX.js';
+import { scanProject } from './chunk-XJMN2HMH.js';
+import './chunk-OGIHOTLP.js';
 import { writeCachedFacts } from './chunk-C7LBUFNU.js';
 import './chunk-6DUDIVIC.js';
 import './chunk-IV3FYVTS.js';

package/dist/scan-M6RKDNYR.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+export { scanProject } from './chunk-XJMN2HMH.js';
+import './chunk-OGIHOTLP.js';
+import './chunk-6DUDIVIC.js';
+import './chunk-IV3FYVTS.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "etymd",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "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-D4M7JXE3.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-export { scanProject } from './chunk-ULEWJ3ZK.js';
-import './chunk-HLWCODYX.js';
-import './chunk-6DUDIVIC.js';
-import './chunk-IV3FYVTS.js';