@yegor256/dogent 0.8.0 → 0.9.0

package/README.md

@@ -64,6 +64,7 @@ The command exits with a non-zero status when problems are found,
 - Every line must be an instruction.
 - Instructions must be grouped in sections.
 - Section names must be short, 1-3 words.
+- Every section must be a level-2 (`##`) heading, below the lone `#` title.
 - Every line must be no longer than 80 symbols.
 - The whole file must stay under 4000 tokens.
 - Every line must sound like a command.

package/package.json

@@ -40,7 +40,7 @@
     "lint": "eslint .",
     "test": "mocha 'test/**/*.js' --timeout 60000"
   },
-  "version": "0.8.0",
+  "version": "0.9.0",
   "dependencies": {
     "minimist": "^1.2.8"
   }

package/src/rules/index.js

@@ -28,11 +28,13 @@ const Passive = require('./passive');
 const Unique = require('./unique');
 const Consistent = require('./consistent');
 const Simple = require('./simple');
+const SectionLevel = require('./section-level');
 
 module.exports = () => [
   new Grouped(),
   new Empty(),
   new ShortSections(),
+  new SectionLevel(),
   new LineLength(80),
   new TokenCount(4000),
   new NoArticles(),

package/src/rules/section-level.js

@@ -0,0 +1,55 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2026 Yegor Bugayenko
+ * SPDX-License-Identifier: MIT
+ */
+
+'use strict';
+
+const Violation = require('../violation');
+const Region = require('../region');
+
+/**
+ * SectionLevel.
+ *
+ * Demands that every section sit at the second level, marked by two
+ * hashes. A lone top-level title may open the file, but any later
+ * first-level heading or any deeper sub-heading breaks the flat shape
+ * a manifesto must keep.
+ *
+ * The check is standalone and deterministic, so prompt() returns an
+ * empty string and the AI oracle never re-checks this rule.
+ */
+class SectionLevel {
+  constructor() {
+    this.id = 'section-level';
+  }
+  prompt() {
+    return '';
+  }
+  violations(document) {
+    const uri = document.uri();
+    return document
+      .walk({
+        header: (text, line, depth) => [{line, depth}],
+        prose: () => [],
+        snippet: () => [],
+        bullets: () => [],
+        frontmatter: () => []
+      })
+      .map((header, index) => this.leveled(header, index, uri))
+      .flat();
+  }
+  leveled(header, index, uri) {
+    if (header.depth === 2 || header.depth === 1 && index === 0) {
+      return [];
+    }
+    return [new Violation(
+      this.id,
+      'error',
+      `section must be a level-2 heading, found ${header.depth}`,
+      new Region(uri, header.line, 1)
+    )];
+  }
+}
+
+module.exports = SectionLevel;

package/src/version.js

@@ -9,8 +9,8 @@
  * Version.
  *
  * The current release of dogent, replaced on every release by rultor.
- * The default `0.8.0` marks an unreleased build straight from source.
+ * The default `0.9.0` marks an unreleased build straight from source.
  */
-const version = '0.8.0';
+const version = '0.9.0';
 
 module.exports = version;