@nurix/etna 0.20.42 → 0.20.44

package/data/harness-index.json

@@ -1,5 +1,5 @@
 {
-    "fingerprint": "bd1f2b63adef",
+    "fingerprint": "192f46e9ad7e",
     "harnesses": {
         "code": {
             "plugin": "code",

package/data/harnesses/code/harness.json

@@ -1,7 +1,7 @@
 {
   "harness": "code",
   "name": "code",
-  "version": "3.20.12",
+  "version": "3.20.14",
   "files": [
     ".prettierignore",
     ".prettierrc.json",
@@ -29,5 +29,5 @@
     "origin": "https://cdn.nustack.io",
     "track": "latest"
   },
-  "digest": "16ebb3336e2e"
+  "digest": "a1ccbb9247d0"
 }

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

@@ -455,10 +455,15 @@ function principleNumbers(lines) {
 // The body's sentences long enough to state a rule, as content-word sets; headings, tables and the footer drop out.
 function sentencesOf(lines) {
   const out = [];
+  // The opening states the document's boundary and points at its neighbours; a sentence there is a pointer, not a rule.
+  let opened = false;
   for (const { n, line } of lines) {
+    if (/^##\s+/.test(line)) opened = true;
+    if (!opened) continue;
     if (DOCTRINE_CLOSING.test(line)) break;
     if (/^\s*(#|\|)/.test(line) || !line.trim()) continue;
-    const plain = line.replace(/^\s*([-*]|\d+\.)\s+/, '').replace(/\*\*[^*]+\*\*:?/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/`/g, '');
+    // A citation's words name where a rule lives; two sentences citing one heading share no rule by it.
+    const plain = line.replace(/^\s*([-*]|\d+\.)\s+/, '').replace(/\*\*[^*]+\*\*:?/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/`/g, '').replace(/\([^()]*(?:principles?\s+\d|§)[^()]*\)/g, '');
     for (const sentence of plain.split(/(?<=[.;])\s+(?=[A-Z(])/)) {
       if (SPEC_SENTENCE.test(sentence)) continue;
       const words = new Set((sentence.toLowerCase().match(/[a-z][a-z'-]+/g) || []).filter((w) => w.length > 2 && !STOPWORDS.has(w)));
@@ -520,12 +525,17 @@ function lintDoctrine(path, text, lines, disabled, findings) {
     const words = bare.replace(/\*\*/g, '').replace(/^\s*([-*]|\d+\.)\s+/, '');
     if (!disabled.has('modal-verb') && /\b(must|should|shall)\b/i.test(words)) findings.push({ path, n, severity: 'warn', id: 'modal-verb', message: 'a modal in a specification — state what happens ("the request is rejected"); being in this document makes it a requirement', excerpt: line.trim().slice(0, 90) });
     if (!disabled.has('question') && /\?(\s|$)/.test(words)) findings.push({ path, n, severity: 'warn', id: 'question', message: 'a question in prose — state the rule declaratively', excerpt: line.trim().slice(0, 90) });
+    // A term the set governs (any sibling's objects:, defined in its Terms table) is a term of art, never a vague synonym.
+    const ownTerms = [...new Set([...siblings.flatMap((d) => d.objects), ...listValue((frontmatter(text) || new Map()).get('objects')).map((o) => o.toLowerCase())])];
+    const unowned = ownTerms.reduce((acc, term) => acc.replace(new RegExp(`\\b${term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}s?\\b`, 'gi'), 'X'), words);
     if (!disabled.has('vague-term')) for (const [pattern, use] of VAGUE_TERMS) {
-      const m = pattern.exec(words);
+      const m = pattern.exec(unowned);
       if (m) { findings.push({ path, n, severity: 'warn', id: 'vague-term', message: `"${m[0]}" — use the standard term: ${use} (references/style-guide.md § Vocabulary)`, excerpt: line.trim().slice(0, 90) }); break; }
     }
     if (!disabled.has('long-sentence')) {
-      for (const sentence of words.split(/(?<=[.;!])\s+(?=[A-Z(])/)) {
+      // A bullet's bold label names the rule; the sentence it leads is counted without it.
+      const unlabelled = bare.replace(/^\s*([-*]|\d+\.)\s+\*\*[^*]+\*\*:?\s*/, '').replace(/\*\*/g, '');
+      for (const sentence of unlabelled.split(/(?<=[.;!])\s+(?=[A-Z(])/)) {
         const list = /:\s/.test(sentence) && (sentence.split(/:\s/).slice(1).join(' ').match(/[,;]/g) || []).length >= 2;
         const count = (sentence.match(/[\w'’-]+/g) || []).length;
         if (count > 25 && !list) { findings.push({ path, n, severity: 'warn', id: 'long-sentence', message: `${count} words in one sentence — about twenty-five at most, one idea each; a colon list is exempt`, excerpt: sentence.trim().slice(0, 90) }); break; }

package/data/harnesses/delivery/harness.json

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

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

@@ -455,10 +455,15 @@ function principleNumbers(lines) {
 // The body's sentences long enough to state a rule, as content-word sets; headings, tables and the footer drop out.
 function sentencesOf(lines) {
   const out = [];
+  // The opening states the document's boundary and points at its neighbours; a sentence there is a pointer, not a rule.
+  let opened = false;
   for (const { n, line } of lines) {
+    if (/^##\s+/.test(line)) opened = true;
+    if (!opened) continue;
     if (DOCTRINE_CLOSING.test(line)) break;
     if (/^\s*(#|\|)/.test(line) || !line.trim()) continue;
-    const plain = line.replace(/^\s*([-*]|\d+\.)\s+/, '').replace(/\*\*[^*]+\*\*:?/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/`/g, '');
+    // A citation's words name where a rule lives; two sentences citing one heading share no rule by it.
+    const plain = line.replace(/^\s*([-*]|\d+\.)\s+/, '').replace(/\*\*[^*]+\*\*:?/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/`/g, '').replace(/\([^()]*(?:principles?\s+\d|§)[^()]*\)/g, '');
     for (const sentence of plain.split(/(?<=[.;])\s+(?=[A-Z(])/)) {
       if (SPEC_SENTENCE.test(sentence)) continue;
       const words = new Set((sentence.toLowerCase().match(/[a-z][a-z'-]+/g) || []).filter((w) => w.length > 2 && !STOPWORDS.has(w)));
@@ -520,12 +525,17 @@ function lintDoctrine(path, text, lines, disabled, findings) {
     const words = bare.replace(/\*\*/g, '').replace(/^\s*([-*]|\d+\.)\s+/, '');
     if (!disabled.has('modal-verb') && /\b(must|should|shall)\b/i.test(words)) findings.push({ path, n, severity: 'warn', id: 'modal-verb', message: 'a modal in a specification — state what happens ("the request is rejected"); being in this document makes it a requirement', excerpt: line.trim().slice(0, 90) });
     if (!disabled.has('question') && /\?(\s|$)/.test(words)) findings.push({ path, n, severity: 'warn', id: 'question', message: 'a question in prose — state the rule declaratively', excerpt: line.trim().slice(0, 90) });
+    // A term the set governs (any sibling's objects:, defined in its Terms table) is a term of art, never a vague synonym.
+    const ownTerms = [...new Set([...siblings.flatMap((d) => d.objects), ...listValue((frontmatter(text) || new Map()).get('objects')).map((o) => o.toLowerCase())])];
+    const unowned = ownTerms.reduce((acc, term) => acc.replace(new RegExp(`\\b${term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}s?\\b`, 'gi'), 'X'), words);
     if (!disabled.has('vague-term')) for (const [pattern, use] of VAGUE_TERMS) {
-      const m = pattern.exec(words);
+      const m = pattern.exec(unowned);
       if (m) { findings.push({ path, n, severity: 'warn', id: 'vague-term', message: `"${m[0]}" — use the standard term: ${use} (references/style-guide.md § Vocabulary)`, excerpt: line.trim().slice(0, 90) }); break; }
     }
     if (!disabled.has('long-sentence')) {
-      for (const sentence of words.split(/(?<=[.;!])\s+(?=[A-Z(])/)) {
+      // A bullet's bold label names the rule; the sentence it leads is counted without it.
+      const unlabelled = bare.replace(/^\s*([-*]|\d+\.)\s+\*\*[^*]+\*\*:?\s*/, '').replace(/\*\*/g, '');
+      for (const sentence of unlabelled.split(/(?<=[.;!])\s+(?=[A-Z(])/)) {
         const list = /:\s/.test(sentence) && (sentence.split(/:\s/).slice(1).join(' ').match(/[,;]/g) || []).length >= 2;
         const count = (sentence.match(/[\w'’-]+/g) || []).length;
         if (count > 25 && !list) { findings.push({ path, n, severity: 'warn', id: 'long-sentence', message: `${count} words in one sentence — about twenty-five at most, one idea each; a colon list is exempt`, excerpt: sentence.trim().slice(0, 90) }); break; }

package/data/harnesses/etna/harness.json

@@ -1,7 +1,7 @@
 {
   "harness": "etna",
   "name": "etna",
-  "version": "1.5.37",
+  "version": "1.5.39",
   "files": [
     ".prettierignore",
     ".prettierrc.json",
@@ -14,5 +14,5 @@
     "origin": "https://cdn.nustack.io",
     "track": "latest"
   },
-  "digest": "d2ee878e5057"
+  "digest": "04e9b6671929"
 }

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

@@ -455,10 +455,15 @@ function principleNumbers(lines) {
 // The body's sentences long enough to state a rule, as content-word sets; headings, tables and the footer drop out.
 function sentencesOf(lines) {
   const out = [];
+  // The opening states the document's boundary and points at its neighbours; a sentence there is a pointer, not a rule.
+  let opened = false;
   for (const { n, line } of lines) {
+    if (/^##\s+/.test(line)) opened = true;
+    if (!opened) continue;
     if (DOCTRINE_CLOSING.test(line)) break;
     if (/^\s*(#|\|)/.test(line) || !line.trim()) continue;
-    const plain = line.replace(/^\s*([-*]|\d+\.)\s+/, '').replace(/\*\*[^*]+\*\*:?/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/`/g, '');
+    // A citation's words name where a rule lives; two sentences citing one heading share no rule by it.
+    const plain = line.replace(/^\s*([-*]|\d+\.)\s+/, '').replace(/\*\*[^*]+\*\*:?/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/`/g, '').replace(/\([^()]*(?:principles?\s+\d|§)[^()]*\)/g, '');
     for (const sentence of plain.split(/(?<=[.;])\s+(?=[A-Z(])/)) {
       if (SPEC_SENTENCE.test(sentence)) continue;
       const words = new Set((sentence.toLowerCase().match(/[a-z][a-z'-]+/g) || []).filter((w) => w.length > 2 && !STOPWORDS.has(w)));
@@ -520,12 +525,17 @@ function lintDoctrine(path, text, lines, disabled, findings) {
     const words = bare.replace(/\*\*/g, '').replace(/^\s*([-*]|\d+\.)\s+/, '');
     if (!disabled.has('modal-verb') && /\b(must|should|shall)\b/i.test(words)) findings.push({ path, n, severity: 'warn', id: 'modal-verb', message: 'a modal in a specification — state what happens ("the request is rejected"); being in this document makes it a requirement', excerpt: line.trim().slice(0, 90) });
     if (!disabled.has('question') && /\?(\s|$)/.test(words)) findings.push({ path, n, severity: 'warn', id: 'question', message: 'a question in prose — state the rule declaratively', excerpt: line.trim().slice(0, 90) });
+    // A term the set governs (any sibling's objects:, defined in its Terms table) is a term of art, never a vague synonym.
+    const ownTerms = [...new Set([...siblings.flatMap((d) => d.objects), ...listValue((frontmatter(text) || new Map()).get('objects')).map((o) => o.toLowerCase())])];
+    const unowned = ownTerms.reduce((acc, term) => acc.replace(new RegExp(`\\b${term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}s?\\b`, 'gi'), 'X'), words);
     if (!disabled.has('vague-term')) for (const [pattern, use] of VAGUE_TERMS) {
-      const m = pattern.exec(words);
+      const m = pattern.exec(unowned);
       if (m) { findings.push({ path, n, severity: 'warn', id: 'vague-term', message: `"${m[0]}" — use the standard term: ${use} (references/style-guide.md § Vocabulary)`, excerpt: line.trim().slice(0, 90) }); break; }
     }
     if (!disabled.has('long-sentence')) {
-      for (const sentence of words.split(/(?<=[.;!])\s+(?=[A-Z(])/)) {
+      // A bullet's bold label names the rule; the sentence it leads is counted without it.
+      const unlabelled = bare.replace(/^\s*([-*]|\d+\.)\s+\*\*[^*]+\*\*:?\s*/, '').replace(/\*\*/g, '');
+      for (const sentence of unlabelled.split(/(?<=[.;!])\s+(?=[A-Z(])/)) {
         const list = /:\s/.test(sentence) && (sentence.split(/:\s/).slice(1).join(' ').match(/[,;]/g) || []).length >= 2;
         const count = (sentence.match(/[\w'’-]+/g) || []).length;
         if (count > 25 && !list) { findings.push({ path, n, severity: 'warn', id: 'long-sentence', message: `${count} words in one sentence — about twenty-five at most, one idea each; a colon list is exempt`, excerpt: sentence.trim().slice(0, 90) }); break; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nurix/etna",
-  "version": "0.20.42",
+  "version": "0.20.44",
   "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": "bd1f2b63adef"
+  "etnaFingerprint": "192f46e9ad7e"
 }