@nurix/etna 0.20.32 → 0.20.34

package/data/harness-index.json

@@ -1,5 +1,5 @@
 {
-    "fingerprint": "1b90a96b3812",
+    "fingerprint": "748e1019e5d8",
     "harnesses": {
         "code": {
             "plugin": "code",

package/data/harnesses/code/harness.json

@@ -1,7 +1,7 @@
 {
   "harness": "code",
   "name": "code",
-  "version": "3.20.3",
+  "version": "3.20.5",
   "files": [
     ".prettierignore",
     ".prettierrc.json",
@@ -29,5 +29,5 @@
     "origin": "https://cdn.nustack.io",
     "track": "latest"
   },
-  "digest": "0bde4238378a"
+  "digest": "00beb7af3c87"
 }

package/data/harnesses/code/hooks/mount.mjs

@@ -184,6 +184,14 @@ function prunableFiles(projectDir, owned) {
   return out.filter((rel) => rel !== '.claude/hooks');
 }
 
+// Whether the owned skills and agents a mount record names are still on disk.
+function ownedOnDisk(projectDir, owned) {
+  if (!owned) return true;
+  for (const name of owned.skills || []) if (!existsSync(join(projectDir, '.claude', 'skills', name))) return false;
+  for (const name of owned.agents || []) if (!existsSync(join(projectDir, '.claude', 'agents', name))) return false;
+  return true;
+}
+
 function unionOwned(...maps) {
   const out = {};
   for (const map of maps) {
@@ -305,7 +313,7 @@ function mountSettings(marker) {
   };
 }
 
-// Mounts the pinned version unless the mount record already names it.
+// Mounts the pinned version unless the mount record already names it and its owned files are on disk.
 async function mountHarness({ projectDir, cacheDir = cacheRoot(), fetchImpl = globalThis.fetch, timeoutMs = 5000, force = false }) {
   const marker = readJsonFile(join(projectDir, '.claude', 'harness.json'));
   if (!marker || !marker.harness || !marker.version) return { status: 'unmarked' };
@@ -313,7 +321,9 @@ async function mountHarness({ projectDir, cacheDir = cacheRoot(), fetchImpl = gl
   const slug = marker.harness;
   const version = marker.version;
   const prior = readJsonFile(join(projectDir, '.claude', 'state', 'mount.json'));
-  if (!force && prior && prior.version === version) return { status: 'current', slug, version, digest: prior.digest };
+  if (!force && prior && prior.version === version && ownedOnDisk(projectDir, prior.owned)) {
+    return { status: 'current', slug, version, digest: prior.digest };
+  }
   let resolved;
   try {
     resolved = await resolveManifest({ origin, slug, version, cacheDir, fetchImpl, timeoutMs });

package/data/harnesses/code/skills/documentation/references/frontmatter.md

@@ -37,7 +37,7 @@ Tooling keys sit beside these on any genre: `rev:` (a generator's generation sta
 ### `description:`
 
 - **Values:** one plain string of at most 300 characters on one line: what the document settles and where its boundary sits, in one or two third-person, present-tense sentences. "How a person signs in to NuStack — the web, command-line and desktop doors, the session each mints, and what a refused sign-in shows; enterprise single sign-on is its own document." The description does not open with "This document"; it carries no file list, no date and no status.
-- **Required on:** every truth document and every folder index; a record carries it wherever its template has frontmatter (a changelog entry's one-line summary is its row in `CHANGELOG.md`). A frozen record that predates the key is never edited to add it. Exempt: `docs/structure.md`, which the installer writes whole, and a tree a generator owns (`docs/dna/`, the product-dna skill's).
+- **Required on:** every truth document and every folder index; a record carries it wherever its template has frontmatter (a changelog entry's one-line summary is its row in `CHANGELOG.md`). A frozen record that predates the key is never edited to add it. Exempt: `docs/structure.md`, which the installer writes whole; `docs/operations/bookkeeping.md`, which the hooks write from a fixed header; and a tree a generator owns (`docs/dna/`, the product-dna skill's). A release note under `docs/operations/release-notes/` is a record, frozen at publication.
 - **Reading:** it is how a folder is browsed without an index row per file: `grep -m1 '^description:' docs/features/*.md`. Tooling that lists documents shows it beside the path.
 - **Upkeep:** an edit that changes what a document settles updates its description in the same edit.
 

package/data/harnesses/code/skills/documentation/scripts/doc-lint.mjs

@@ -28,7 +28,7 @@ const SKIP = /^(\.claude|\.agents|\.codex|skills|rules|agents|harness)\/|(^|\/)(
 // `operations/issues/YYYY-MM-DD-{slug}.md` is a sanctioned record genre (`type: issue`, the
 // `issue-bridge` skill's local pack) living outside the record folders, so it is named here too —
 // graded as a truth document it fails the date rule for carrying the date its filename already does.
-const RECORD = /(^|\/)docs\/(history|research|memory)\/|(^|\/)docs\/operations\/issues\//;
+const RECORD = /(^|\/)docs\/(history|research|memory)\/|(^|\/)docs\/operations\/issues\/|(^|\/)docs\/operations\/release-notes\/(?!readme\.md$)[^/]+\.md$/i;
 
 const RECORD_TYPES = /^(changelog-entry|plan|migration|migration-runbook|research|brainstorm|journal|record|ledger|issue|triage|project-memory|agent-memory)$/;
 const TRUTH_LOCATIONS = /(^|\/)docs\/(features|architecture|tests|acceptance)\//;
@@ -152,6 +152,8 @@ function lintFile(path, findings) {
   // A file or record named without a link is the same per-file row as a link (SKILL.md § Every document describes itself).
   // docs/dna/ is the product-dna skill's generated tree, laid out by that skill's own schema.
   const isGeneratedTree = /(^|\/)docs\/dna\//.test(path);
+  // The bookkeeping queue is written by the harness hooks from a fixed header (hooks/lib/state.mjs); it carries no frontmatter.
+  const isHookQueue = /(^|\/)docs\/operations\/bookkeeping\.md$/.test(path);
   if (scope === 'truth' && isFolderIndex && /(^|\/)docs\//.test(path) && !isGeneratedTree && !disabled.has('index-names-records')) {
     const SCAFFOLD_NAME = /^(readme|structure|changelog|backlog|main|health-log|journal|claude|agents|setup)\.md$/i;
     for (const { n, line } of lines) {
@@ -162,7 +164,7 @@ function lintFile(path, findings) {
     }
   }
   // Every truth document and folder index under docs/ describes itself in at most 300 characters (references/frontmatter.md § description:).
-  if (scope === 'truth' && /(^|\/)docs\//.test(path) && !isGeneratedTree && !isAuthorityMap && !disabled.has('description-missing')) {
+  if (scope === 'truth' && /(^|\/)docs\//.test(path) && !isGeneratedTree && !isAuthorityMap && !isHookQueue && !disabled.has('description-missing')) {
     const fmEnd = text.startsWith('---') ? text.indexOf('\n---', 3) : -1;
     const fmText = fmEnd === -1 ? '' : text.slice(0, fmEnd);
     const m = /^description:[ \t]*(.*)$/m.exec(fmText);

package/data/harnesses/delivery/harness.json

@@ -1,7 +1,7 @@
 {
   "harness": "delivery",
   "name": "delivery",
-  "version": "0.2.40",
+  "version": "0.2.41",
   "files": [
     ".prettierignore",
     ".prettierrc.json",
@@ -14,5 +14,5 @@
     "origin": "https://cdn.nustack.io",
     "track": "latest"
   },
-  "digest": "5a9f81fff98a"
+  "digest": "0b5c0a49d7ba"
 }

package/data/harnesses/delivery/skills/documentation/references/frontmatter.md

@@ -37,7 +37,7 @@ Tooling keys sit beside these on any genre: `rev:` (a generator's generation sta
 ### `description:`
 
 - **Values:** one plain string of at most 300 characters on one line: what the document settles and where its boundary sits, in one or two third-person, present-tense sentences. "How a person signs in to NuStack — the web, command-line and desktop doors, the session each mints, and what a refused sign-in shows; enterprise single sign-on is its own document." The description does not open with "This document"; it carries no file list, no date and no status.
-- **Required on:** every truth document and every folder index; a record carries it wherever its template has frontmatter (a changelog entry's one-line summary is its row in `CHANGELOG.md`). A frozen record that predates the key is never edited to add it. Exempt: `docs/structure.md`, which the installer writes whole, and a tree a generator owns (`docs/dna/`, the product-dna skill's).
+- **Required on:** every truth document and every folder index; a record carries it wherever its template has frontmatter (a changelog entry's one-line summary is its row in `CHANGELOG.md`). A frozen record that predates the key is never edited to add it. Exempt: `docs/structure.md`, which the installer writes whole; `docs/operations/bookkeeping.md`, which the hooks write from a fixed header; and a tree a generator owns (`docs/dna/`, the product-dna skill's). A release note under `docs/operations/release-notes/` is a record, frozen at publication.
 - **Reading:** it is how a folder is browsed without an index row per file: `grep -m1 '^description:' docs/features/*.md`. Tooling that lists documents shows it beside the path.
 - **Upkeep:** an edit that changes what a document settles updates its description in the same edit.
 

package/data/harnesses/delivery/skills/documentation/scripts/doc-lint.mjs

@@ -28,7 +28,7 @@ const SKIP = /^(\.claude|\.agents|\.codex|skills|rules|agents|harness)\/|(^|\/)(
 // `operations/issues/YYYY-MM-DD-{slug}.md` is a sanctioned record genre (`type: issue`, the
 // `issue-bridge` skill's local pack) living outside the record folders, so it is named here too —
 // graded as a truth document it fails the date rule for carrying the date its filename already does.
-const RECORD = /(^|\/)docs\/(history|research|memory)\/|(^|\/)docs\/operations\/issues\//;
+const RECORD = /(^|\/)docs\/(history|research|memory)\/|(^|\/)docs\/operations\/issues\/|(^|\/)docs\/operations\/release-notes\/(?!readme\.md$)[^/]+\.md$/i;
 
 const RECORD_TYPES = /^(changelog-entry|plan|migration|migration-runbook|research|brainstorm|journal|record|ledger|issue|triage|project-memory|agent-memory)$/;
 const TRUTH_LOCATIONS = /(^|\/)docs\/(features|architecture|tests|acceptance)\//;
@@ -152,6 +152,8 @@ function lintFile(path, findings) {
   // A file or record named without a link is the same per-file row as a link (SKILL.md § Every document describes itself).
   // docs/dna/ is the product-dna skill's generated tree, laid out by that skill's own schema.
   const isGeneratedTree = /(^|\/)docs\/dna\//.test(path);
+  // The bookkeeping queue is written by the harness hooks from a fixed header (hooks/lib/state.mjs); it carries no frontmatter.
+  const isHookQueue = /(^|\/)docs\/operations\/bookkeeping\.md$/.test(path);
   if (scope === 'truth' && isFolderIndex && /(^|\/)docs\//.test(path) && !isGeneratedTree && !disabled.has('index-names-records')) {
     const SCAFFOLD_NAME = /^(readme|structure|changelog|backlog|main|health-log|journal|claude|agents|setup)\.md$/i;
     for (const { n, line } of lines) {
@@ -162,7 +164,7 @@ function lintFile(path, findings) {
     }
   }
   // Every truth document and folder index under docs/ describes itself in at most 300 characters (references/frontmatter.md § description:).
-  if (scope === 'truth' && /(^|\/)docs\//.test(path) && !isGeneratedTree && !isAuthorityMap && !disabled.has('description-missing')) {
+  if (scope === 'truth' && /(^|\/)docs\//.test(path) && !isGeneratedTree && !isAuthorityMap && !isHookQueue && !disabled.has('description-missing')) {
     const fmEnd = text.startsWith('---') ? text.indexOf('\n---', 3) : -1;
     const fmText = fmEnd === -1 ? '' : text.slice(0, fmEnd);
     const m = /^description:[ \t]*(.*)$/m.exec(fmText);

package/data/harnesses/etna/harness.json

@@ -1,7 +1,7 @@
 {
   "harness": "etna",
   "name": "etna",
-  "version": "1.5.30",
+  "version": "1.5.31",
   "files": [
     ".prettierignore",
     ".prettierrc.json",
@@ -14,5 +14,5 @@
     "origin": "https://cdn.nustack.io",
     "track": "latest"
   },
-  "digest": "02bf4a5e9588"
+  "digest": "2c3760e696b9"
 }

package/data/harnesses/etna/skills/documentation/references/frontmatter.md

@@ -37,7 +37,7 @@ Tooling keys sit beside these on any genre: `rev:` (a generator's generation sta
 ### `description:`
 
 - **Values:** one plain string of at most 300 characters on one line: what the document settles and where its boundary sits, in one or two third-person, present-tense sentences. "How a person signs in to NuStack — the web, command-line and desktop doors, the session each mints, and what a refused sign-in shows; enterprise single sign-on is its own document." The description does not open with "This document"; it carries no file list, no date and no status.
-- **Required on:** every truth document and every folder index; a record carries it wherever its template has frontmatter (a changelog entry's one-line summary is its row in `CHANGELOG.md`). A frozen record that predates the key is never edited to add it. Exempt: `docs/structure.md`, which the installer writes whole, and a tree a generator owns (`docs/dna/`, the product-dna skill's).
+- **Required on:** every truth document and every folder index; a record carries it wherever its template has frontmatter (a changelog entry's one-line summary is its row in `CHANGELOG.md`). A frozen record that predates the key is never edited to add it. Exempt: `docs/structure.md`, which the installer writes whole; `docs/operations/bookkeeping.md`, which the hooks write from a fixed header; and a tree a generator owns (`docs/dna/`, the product-dna skill's). A release note under `docs/operations/release-notes/` is a record, frozen at publication.
 - **Reading:** it is how a folder is browsed without an index row per file: `grep -m1 '^description:' docs/features/*.md`. Tooling that lists documents shows it beside the path.
 - **Upkeep:** an edit that changes what a document settles updates its description in the same edit.
 

package/data/harnesses/etna/skills/documentation/scripts/doc-lint.mjs

@@ -28,7 +28,7 @@ const SKIP = /^(\.claude|\.agents|\.codex|skills|rules|agents|harness)\/|(^|\/)(
 // `operations/issues/YYYY-MM-DD-{slug}.md` is a sanctioned record genre (`type: issue`, the
 // `issue-bridge` skill's local pack) living outside the record folders, so it is named here too —
 // graded as a truth document it fails the date rule for carrying the date its filename already does.
-const RECORD = /(^|\/)docs\/(history|research|memory)\/|(^|\/)docs\/operations\/issues\//;
+const RECORD = /(^|\/)docs\/(history|research|memory)\/|(^|\/)docs\/operations\/issues\/|(^|\/)docs\/operations\/release-notes\/(?!readme\.md$)[^/]+\.md$/i;
 
 const RECORD_TYPES = /^(changelog-entry|plan|migration|migration-runbook|research|brainstorm|journal|record|ledger|issue|triage|project-memory|agent-memory)$/;
 const TRUTH_LOCATIONS = /(^|\/)docs\/(features|architecture|tests|acceptance)\//;
@@ -152,6 +152,8 @@ function lintFile(path, findings) {
   // A file or record named without a link is the same per-file row as a link (SKILL.md § Every document describes itself).
   // docs/dna/ is the product-dna skill's generated tree, laid out by that skill's own schema.
   const isGeneratedTree = /(^|\/)docs\/dna\//.test(path);
+  // The bookkeeping queue is written by the harness hooks from a fixed header (hooks/lib/state.mjs); it carries no frontmatter.
+  const isHookQueue = /(^|\/)docs\/operations\/bookkeeping\.md$/.test(path);
   if (scope === 'truth' && isFolderIndex && /(^|\/)docs\//.test(path) && !isGeneratedTree && !disabled.has('index-names-records')) {
     const SCAFFOLD_NAME = /^(readme|structure|changelog|backlog|main|health-log|journal|claude|agents|setup)\.md$/i;
     for (const { n, line } of lines) {
@@ -162,7 +164,7 @@ function lintFile(path, findings) {
     }
   }
   // Every truth document and folder index under docs/ describes itself in at most 300 characters (references/frontmatter.md § description:).
-  if (scope === 'truth' && /(^|\/)docs\//.test(path) && !isGeneratedTree && !isAuthorityMap && !disabled.has('description-missing')) {
+  if (scope === 'truth' && /(^|\/)docs\//.test(path) && !isGeneratedTree && !isAuthorityMap && !isHookQueue && !disabled.has('description-missing')) {
     const fmEnd = text.startsWith('---') ? text.indexOf('\n---', 3) : -1;
     const fmText = fmEnd === -1 ? '' : text.slice(0, fmEnd);
     const m = /^description:[ \t]*(.*)$/m.exec(fmText);

package/lib/install/mount.mjs

@@ -182,6 +182,14 @@ function prunableFiles(projectDir, owned) {
   return out.filter((rel) => rel !== '.claude/hooks');
 }
 
+// Whether the owned skills and agents a mount record names are still on disk.
+function ownedOnDisk(projectDir, owned) {
+  if (!owned) return true;
+  for (const name of owned.skills || []) if (!existsSync(join(projectDir, '.claude', 'skills', name))) return false;
+  for (const name of owned.agents || []) if (!existsSync(join(projectDir, '.claude', 'agents', name))) return false;
+  return true;
+}
+
 function unionOwned(...maps) {
   const out = {};
   for (const map of maps) {
@@ -303,7 +311,7 @@ function mountSettings(marker) {
   };
 }
 
-// Mounts the pinned version unless the mount record already names it.
+// Mounts the pinned version unless the mount record already names it and its owned files are on disk.
 async function mountHarness({ projectDir, cacheDir = cacheRoot(), fetchImpl = globalThis.fetch, timeoutMs = 5000, force = false }) {
   const marker = readJsonFile(join(projectDir, '.claude', 'harness.json'));
   if (!marker || !marker.harness || !marker.version) return { status: 'unmarked' };
@@ -311,7 +319,9 @@ async function mountHarness({ projectDir, cacheDir = cacheRoot(), fetchImpl = gl
   const slug = marker.harness;
   const version = marker.version;
   const prior = readJsonFile(join(projectDir, '.claude', 'state', 'mount.json'));
-  if (!force && prior && prior.version === version) return { status: 'current', slug, version, digest: prior.digest };
+  if (!force && prior && prior.version === version && ownedOnDisk(projectDir, prior.owned)) {
+    return { status: 'current', slug, version, digest: prior.digest };
+  }
   let resolved;
   try {
     resolved = await resolveManifest({ origin, slug, version, cacheDir, fetchImpl, timeoutMs });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nurix/etna",
-  "version": "0.20.32",
+  "version": "0.20.34",
   "description": "Bootstrap a project with a Nurix harness — writes the committed contract (CLAUDE.md, AGENTS.md, .claude/harness.json, settings.json, the mount hook) and mounts the harness itself, gitignored, from a bundled payload; sessions keep it current from the CDN.",
   "type": "module",
   "bin": {
@@ -46,5 +46,5 @@
     "agent",
     "plugin"
   ],
-  "etnaFingerprint": "1b90a96b3812"
+  "etnaFingerprint": "748e1019e5d8"
 }