@greyworld/code-check-core 1.0.0

package/dist/workflow/implement/resource-check/rules/markdown-format/attributes/attribute-section-format-rule.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttributeSectionFormatRule = void 0;
+const markdown_1 = require("../../../../../../tools/ast-parser/markdown");
+const section_check_1 = require("../../../../../../tools/section-check");
+const rule_1 = require("../../../../../types/rule/rule");
+const builder_1 = require("../../../tools/doc-semantic/builder");
+const section_check_result_1 = require("../shared/section-check-result");
+const ATTRIBUTE_SECTION_TITLES = ["Attributes Reference", "Attribute Reference"];
+const META = {
+    name: "md-attribute-section-format",
+    description: "Validate Attribute Reference section list structure and bullet style",
+    messages: {
+        missingList: "Attribute Reference section exists but does not contain a bullet list.",
+        invalidItem: (line, reason) => `Invalid attribute bullet format at line ${String(line)}: ${String(reason)}`,
+        summary: (count) => `${String(count)} attribute bullet format issue(s) found`,
+    },
+};
+class AttributeSectionFormatRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(code, ast, _parentCtx) {
+        if (!ast) {
+            return [rule_1.RuleCheckResult.pass("AST unavailable, rule skipped")];
+        }
+        const doc = ast;
+        const sectionInfo = getSectionByTitles(this.parser, doc, ATTRIBUTE_SECTION_TITLES);
+        if (!sectionInfo) {
+            return [rule_1.RuleCheckResult.pass("Attribute Reference section not found, skipped")];
+        }
+        const failures = await (0, section_check_1.sectionCheck)(sectionInfo.title, 2)
+            .requireBulletList({
+            includeNestedLists: true,
+            message: this.msg("missingList"),
+        })
+            .eachBulletItem((line) => line.matches(builder_1.ATTR_BULLET_PATTERN), {
+            includeNestedLists: false,
+        })
+            .run(doc, code);
+        if (failures.length === 1 && failures[0].message === this.msg("missingList")) {
+            return [this.fail("missingList", "", undefined, rule_1.RuleCheckResult.fromLine(1))];
+        }
+        return (0, section_check_result_1.toSectionRuleResults)(failures, {
+            passMessage: "Attribute Reference section format is valid",
+            summaryMessage: (count) => this.msg("summary", count),
+        });
+    }
+}
+exports.AttributeSectionFormatRule = AttributeSectionFormatRule;
+function getSectionByTitles(parser, doc, titles) {
+    for (const title of titles) {
+        const section = parser.getSection(doc, 2, title);
+        if (section)
+            return { title, nodes: section };
+    }
+    return null;
+}
+//# sourceMappingURL=attribute-section-format-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/attributes/attribute-section-format-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-section-format-rule.js","sourceRoot":"","sources":["../../../../../../../src/workflow/implement/resource-check/rules/markdown-format/attributes/attribute-section-format-rule.ts"],"names":[],"mappings":";;;AACA,0EAA6E;AAC7E,yEAAqE;AACrE,yDAAsF;AAEtF,iEAA0E;AAC1E,yEAAsE;AAEtE,MAAM,wBAAwB,GAAG,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,CAAC;AAEjF,MAAM,IAAI,GAAa;IACnB,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,sEAAsE;IACnF,QAAQ,EAAE;QACN,WAAW,EACP,wEAAwE;QAC5E,WAAW,EAAE,CAAC,IAAa,EAAE,MAAe,EAAE,EAAE,CAC5C,2CAA2C,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,EAAE;QAChF,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE,CACxB,GAAG,MAAM,CAAC,KAAK,CAAC,yCAAyC;KAChE;CACJ,CAAC;AAEF,MAAa,0BAA2B,SAAQ,WAAI;IAGhD;QACI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAHX,WAAM,GAAG,IAAI,yBAAc,EAAE,CAAC;IAI/C,CAAC;IAEM,KAAK,CAAC,IAAI,CACb,IAAY,EACZ,GAAa,EACb,UAAoB;QAEpB,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,CAAC,sBAAe,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,GAAG,GAAG,GAAmB,CAAC;QAChC,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,wBAAwB,CAAC,CAAC;QACnF,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,OAAO,CAAC,sBAAe,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAA,4BAAY,EAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;aACpD,iBAAiB,CAAC;YACf,kBAAkB,EAAE,IAAI;YACxB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;SACnC,CAAC;aACD,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,6BAAmB,CAAC,EAAE;YACzD,kBAAkB,EAAE,KAAK;SAC5B,CAAC;aACD,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEpB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,sBAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC;QAED,OAAO,IAAA,2CAAoB,EAAC,QAAQ,EAAE;YAClC,WAAW,EAAE,6CAA6C;YAC1D,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC;SACxD,CAAC,CAAC;IACP,CAAC;CACJ;AAzCD,gEAyCC;AAED,SAAS,kBAAkB,CACvB,MAAsB,EACtB,GAAiB,EACjB,MAAgB;IAEhB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/blank-line-between-blocks-rule.d.ts

@@ -0,0 +1,9 @@
+import { Rule, RuleCheckResult } from "../../../../types/rule/rule";
+import type { Context } from "../../../../context/context";
+export declare class BlankLineBetweenBlocksRule extends Rule {
+    constructor();
+    test(code: string, ast?: unknown, _parentCtx?: Context): Promise<RuleCheckResult[]>;
+    private shouldCheckBoundary;
+    private hasBlankLineBetween;
+}
+//# sourceMappingURL=blank-line-between-blocks-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-format/blank-line-between-blocks-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blank-line-between-blocks-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/blank-line-between-blocks-rule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAuB3D,qBAAa,0BAA2B,SAAQ,IAAI;;IAKnC,IAAI,CACb,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC;IAkD7B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,mBAAmB;CAY9B"}

package/dist/workflow/implement/resource-check/rules/markdown-format/blank-line-between-blocks-rule.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlankLineBetweenBlocksRule = void 0;
+const rule_1 = require("../../../../types/rule/rule");
+const META = {
+    name: "md-blank-line-between-blocks",
+    description: "Top-level markdown blocks should be separated by a blank line",
+    messages: {
+        missing: (prevType, currType, line) => `Missing blank line between ${String(prevType)} and ${String(currType)} blocks ` +
+            `before line ${String(line)}.`,
+        summary: (count) => `${String(count)} block boundary issue(s) found`,
+    },
+};
+const BLOCK_TYPES_REQUIRING_SEPARATOR = new Set([
+    "heading",
+    "paragraph",
+    "list",
+    "code_block",
+    "block_quote",
+    "html_block",
+]);
+class BlankLineBetweenBlocksRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+    }
+    async test(code, ast, _parentCtx) {
+        if (!ast) {
+            return [rule_1.RuleCheckResult.pass("AST unavailable, rule skipped")];
+        }
+        const doc = ast;
+        const blocks = doc.children.filter((n) => n.type !== "frontmatter");
+        const lines = code.split(/\r?\n/);
+        const violations = [];
+        for (let i = 1; i < blocks.length; i++) {
+            const prev = blocks[i - 1];
+            const curr = blocks[i];
+            if (!this.shouldCheckBoundary(prev, curr))
+                continue;
+            const prevEnd = prev.sourceRange?.end.line;
+            const currStart = curr.sourceRange?.start.line;
+            if (!prevEnd || !currStart || currStart <= prevEnd)
+                continue;
+            if (!this.hasBlankLineBetween(lines, prevEnd, currStart)) {
+                const line = currStart;
+                violations.push(this.fail("missing", lines[line - 1] ?? "", lines[line - 1] ?? "", rule_1.RuleCheckResult.fromLine(line), prev.type, curr.type, line));
+            }
+        }
+        if (violations.length === 0) {
+            return [rule_1.RuleCheckResult.pass("All top-level block boundaries have blank lines")];
+        }
+        return [
+            new rule_1.RuleCheckResult(false, this.msg("summary", violations.length), "", "", violations),
+        ];
+    }
+    shouldCheckBoundary(prev, curr) {
+        if (!BLOCK_TYPES_REQUIRING_SEPARATOR.has(prev.type))
+            return false;
+        if (!BLOCK_TYPES_REQUIRING_SEPARATOR.has(curr.type))
+            return false;
+        // Allow adjacent headings for intentionally empty sections.
+        if (prev.type === "heading" && curr.type === "heading") {
+            return false;
+        }
+        return true;
+    }
+    hasBlankLineBetween(lines, prevEndLine, currStartLine) {
+        const start = prevEndLine + 1;
+        const end = currStartLine - 1;
+        if (start > end)
+            return false;
+        for (let line = start; line <= end; line++) {
+            if ((lines[line - 1] ?? "").trim() === "") {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+exports.BlankLineBetweenBlocksRule = BlankLineBetweenBlocksRule;
+//# sourceMappingURL=blank-line-between-blocks-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/blank-line-between-blocks-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blank-line-between-blocks-rule.js","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/blank-line-between-blocks-rule.ts"],"names":[],"mappings":"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"}

package/dist/workflow/implement/resource-check/rules/markdown-format/example/example-section-exists-rule.d.ts

@@ -0,0 +1,8 @@
+import { Rule, RuleCheckResult } from "../../../../../types/rule/rule";
+import type { Context } from "../../../../../context/context";
+export declare class ExampleSectionExistsRule extends Rule {
+    private readonly parser;
+    constructor();
+    test(code: string, ast?: unknown, _parentCtx?: Context): Promise<RuleCheckResult[]>;
+}
+//# sourceMappingURL=example-section-exists-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-format/example/example-section-exists-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-section-exists-rule.d.ts","sourceRoot":"","sources":["../../../../../../../src/workflow/implement/resource-check/rules/markdown-format/example/example-section-exists-rule.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAW9D,qBAAa,wBAAyB,SAAQ,IAAI;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;;IAMlC,IAAI,CACb,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC;CA0BhC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/example/example-section-exists-rule.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExampleSectionExistsRule = void 0;
+const markdown_1 = require("../../../../../../tools/ast-parser/markdown");
+const section_check_1 = require("../../../../../../tools/section-check");
+const rule_1 = require("../../../../../types/rule/rule");
+const META = {
+    name: "md-example-section-exists",
+    description: "Document must contain an 'Example Usage' section",
+    messages: {
+        missing: "Document must contain an 'Example Usage' section (## Example Usage)",
+    },
+};
+class ExampleSectionExistsRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(code, ast, _parentCtx) {
+        if (!ast) {
+            return [this.fail("missing", "")];
+        }
+        const doc = ast;
+        const failures = await (0, section_check_1.bodyCheck)()
+            .validate(({ nodes, startLine }) => {
+            const hasExampleSection = nodes.some((node) => node.type === "heading" &&
+                (node.level ?? 0) === 2 &&
+                this.parser.getTextContent(node).trim() === "Example Usage");
+            if (hasExampleSection)
+                return [];
+            return [{ message: this.msg("missing"), line: startLine }];
+        })
+            .run(doc, code);
+        if (failures.length === 0) {
+            return [rule_1.RuleCheckResult.pass("Example Usage section exists")];
+        }
+        const line = failures[0].line ?? 1;
+        return [this.fail("missing", "", undefined, rule_1.RuleCheckResult.fromLine(line))];
+    }
+}
+exports.ExampleSectionExistsRule = ExampleSectionExistsRule;
+//# sourceMappingURL=example-section-exists-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/example/example-section-exists-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-section-exists-rule.js","sourceRoot":"","sources":["../../../../../../../src/workflow/implement/resource-check/rules/markdown-format/example/example-section-exists-rule.ts"],"names":[],"mappings":";;;AACA,0EAA6E;AAC7E,yEAAkE;AAClE,yDAAsF;AAGtF,MAAM,IAAI,GAAa;IACnB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,kDAAkD;IAC/D,QAAQ,EAAE;QACN,OAAO,EACH,qEAAqE;KAC5E;CACJ,CAAC;AAEF,MAAa,wBAAyB,SAAQ,WAAI;IAG9C;QACI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAHX,WAAM,GAAG,IAAI,yBAAc,EAAE,CAAC;IAI/C,CAAC;IAEM,KAAK,CAAC,IAAI,CACb,IAAY,EACZ,GAAa,EACb,UAAoB;QAEpB,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,GAAG,GAAG,GAAmB,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAS,GAAE;aAC7B,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;YAC/B,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAChC,CAAC,IAAI,EAAE,EAAE,CACL,IAAI,CAAC,IAAI,KAAK,SAAS;gBACvB,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC;gBACvB,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,eAAe,CAClE,CAAC;YACF,IAAI,iBAAiB;gBAAE,OAAO,EAAE,CAAC;YACjC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC;aACD,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEpB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,sBAAe,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,sBAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;CACJ;AArCD,4DAqCC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/example-section-exists-rule.d.ts

@@ -0,0 +1,8 @@
+import { Rule, RuleCheckResult } from "../../../../types/rule/rule";
+import type { Context } from "../../../../context/context";
+export declare class ExampleSectionExistsRule extends Rule {
+    private readonly parser;
+    constructor();
+    test(_code: string, ast?: unknown, _parentCtx?: Context): Promise<RuleCheckResult[]>;
+}
+//# sourceMappingURL=example-section-exists-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-format/example-section-exists-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-section-exists-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/example-section-exists-rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAW3D,qBAAa,wBAAyB,SAAQ,IAAI;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;;IAMlC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC;CAoBhC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/example-section-exists-rule.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExampleSectionExistsRule = void 0;
+const markdown_1 = require("../../../../../tools/ast-parser/markdown");
+const rule_1 = require("../../../../types/rule/rule");
+const META = {
+    name: "md-example-section-exists",
+    description: "Document must contain an 'Example Usage' section",
+    messages: {
+        missing: "Document must contain an 'Example Usage' section (## Example Usage)",
+    },
+};
+class ExampleSectionExistsRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(_code, ast, _parentCtx) {
+        if (!ast) {
+            return [this.fail("missing", "")];
+        }
+        const doc = ast;
+        const section = this.parser.getSection(doc, 2, "Example Usage");
+        if (section && section.length > 0) {
+            const firstNode = section[0];
+            return [
+                rule_1.RuleCheckResult.pass("Example Usage section exists", firstNode.sourceRange ?? undefined),
+            ];
+        }
+        return [this.fail("missing", "", undefined, rule_1.RuleCheckResult.fromLine(1))];
+    }
+}
+exports.ExampleSectionExistsRule = ExampleSectionExistsRule;
+//# sourceMappingURL=example-section-exists-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/example-section-exists-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-section-exists-rule.js","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/example-section-exists-rule.ts"],"names":[],"mappings":";;;AACA,uEAA0E;AAC1E,sDAAmF;AAGnF,MAAM,IAAI,GAAa;IACnB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,kDAAkD;IAC/D,QAAQ,EAAE;QACN,OAAO,EACH,qEAAqE;KAC5E;CACJ,CAAC;AAEF,MAAa,wBAAyB,SAAQ,WAAI;IAG9C;QACI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAHX,WAAM,GAAG,IAAI,yBAAc,EAAE,CAAC;IAI/C,CAAC;IAEM,KAAK,CAAC,IAAI,CACb,KAAa,EACb,GAAa,EACb,UAAoB;QAEpB,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,GAAG,GAAG,GAAmB,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QAEhE,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC7B,OAAO;gBACH,sBAAe,CAAC,IAAI,CAChB,8BAA8B,EAC9B,SAAS,CAAC,WAAW,IAAI,SAAS,CACrC;aACJ,CAAC;QACN,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,sBAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;CACJ;AA/BD,4DA+BC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/frontmatter/frontmatter-check-rule.d.ts

@@ -0,0 +1,8 @@
+import { Rule, RuleCheckResult } from "../../../../../types/rule/rule";
+import type { Context } from "../../../../../context/context";
+export declare class FrontmatterCheckRule extends Rule {
+    private readonly parser;
+    constructor();
+    test(_code: string, ast?: unknown, _parentCtx?: Context): Promise<RuleCheckResult[]>;
+}
+//# sourceMappingURL=frontmatter-check-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-format/frontmatter/frontmatter-check-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-check-rule.d.ts","sourceRoot":"","sources":["../../../../../../../src/workflow/implement/resource-check/rules/markdown-format/frontmatter/frontmatter-check-rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAW9D,qBAAa,oBAAqB,SAAQ,IAAI;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;;IAMlC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC;CAmBhC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/frontmatter/frontmatter-check-rule.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontmatterCheckRule = void 0;
+const markdown_1 = require("../../../../../../tools/ast-parser/markdown");
+const rule_1 = require("../../../../../types/rule/rule");
+const META = {
+    name: "md-frontmatter-check",
+    description: "Front matter block must exist at the start of the document",
+    messages: {
+        missing: "Missing front matter block at the start of the document",
+    },
+};
+class FrontmatterCheckRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(_code, ast, _parentCtx) {
+        if (!ast) {
+            return [this.fail("missing", "")];
+        }
+        const doc = ast;
+        const fm = this.parser.findFirst(doc, (n) => n.type === "frontmatter");
+        if (fm) {
+            return [
+                rule_1.RuleCheckResult.pass("Front matter block exists", fm.sourceRange ?? undefined),
+            ];
+        }
+        return [this.fail("missing", "", undefined, rule_1.RuleCheckResult.fromLine(1))];
+    }
+}
+exports.FrontmatterCheckRule = FrontmatterCheckRule;
+//# sourceMappingURL=frontmatter-check-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/frontmatter/frontmatter-check-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-check-rule.js","sourceRoot":"","sources":["../../../../../../../src/workflow/implement/resource-check/rules/markdown-format/frontmatter/frontmatter-check-rule.ts"],"names":[],"mappings":";;;AACA,0EAA6E;AAC7E,yDAAsF;AAGtF,MAAM,IAAI,GAAa;IACnB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACP,4DAA4D;IAChE,QAAQ,EAAE;QACN,OAAO,EAAE,yDAAyD;KACrE;CACJ,CAAC;AAEF,MAAa,oBAAqB,SAAQ,WAAI;IAG1C;QACI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAHX,WAAM,GAAG,IAAI,yBAAc,EAAE,CAAC;IAI/C,CAAC;IAEM,KAAK,CAAC,IAAI,CACb,KAAa,EACb,GAAa,EACb,UAAoB;QAEpB,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,GAAG,GAAG,GAAmB,CAAC;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;QAEvE,IAAI,EAAE,EAAE,CAAC;YACL,OAAO;gBACH,sBAAe,CAAC,IAAI,CAChB,2BAA2B,EAC3B,EAAE,CAAC,WAAW,IAAI,SAAS,CAC9B;aACJ,CAAC;QACN,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,sBAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;CACJ;AA9BD,oDA8BC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/frontmatter-check-rule.d.ts

@@ -0,0 +1,8 @@
+import { Rule, RuleCheckResult } from "../../../../types/rule/rule";
+import type { Context } from "../../../../context/context";
+export declare class FrontmatterCheckRule extends Rule {
+    private readonly parser;
+    constructor();
+    test(_code: string, ast?: unknown, _parentCtx?: Context): Promise<RuleCheckResult[]>;
+}
+//# sourceMappingURL=frontmatter-check-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-format/frontmatter-check-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-check-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/frontmatter-check-rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAW3D,qBAAa,oBAAqB,SAAQ,IAAI;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;;IAMlC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC;CAmBhC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/frontmatter-check-rule.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontmatterCheckRule = void 0;
+const markdown_1 = require("../../../../../tools/ast-parser/markdown");
+const rule_1 = require("../../../../types/rule/rule");
+const META = {
+    name: "md-frontmatter-check",
+    description: "Front matter block must exist at the start of the document",
+    messages: {
+        missing: "Missing front matter block at the start of the document",
+    },
+};
+class FrontmatterCheckRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(_code, ast, _parentCtx) {
+        if (!ast) {
+            return [this.fail("missing", "")];
+        }
+        const doc = ast;
+        const fm = this.parser.findFirst(doc, (n) => n.type === "frontmatter");
+        if (fm) {
+            return [
+                rule_1.RuleCheckResult.pass("Front matter block exists", fm.sourceRange ?? undefined),
+            ];
+        }
+        return [this.fail("missing", "", undefined, rule_1.RuleCheckResult.fromLine(1))];
+    }
+}
+exports.FrontmatterCheckRule = FrontmatterCheckRule;
+//# sourceMappingURL=frontmatter-check-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/frontmatter-check-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-check-rule.js","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/frontmatter-check-rule.ts"],"names":[],"mappings":";;;AACA,uEAA0E;AAC1E,sDAAmF;AAGnF,MAAM,IAAI,GAAa;IACnB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACP,4DAA4D;IAChE,QAAQ,EAAE;QACN,OAAO,EAAE,yDAAyD;KACrE;CACJ,CAAC;AAEF,MAAa,oBAAqB,SAAQ,WAAI;IAG1C;QACI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAHX,WAAM,GAAG,IAAI,yBAAc,EAAE,CAAC;IAI/C,CAAC;IAEM,KAAK,CAAC,IAAI,CACb,KAAa,EACb,GAAa,EACb,UAAoB;QAEpB,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,GAAG,GAAG,GAAmB,CAAC;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;QAEvE,IAAI,EAAE,EAAE,CAAC;YACL,OAAO;gBACH,sBAAe,CAAC,IAAI,CAChB,2BAA2B,EAC3B,EAAE,CAAC,WAAW,IAAI,SAAS,CAC9B;aACJ,CAAC;QACN,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,sBAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;CACJ;AA9BD,oDA8BC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/h1-exists-rule.d.ts

@@ -0,0 +1,8 @@
+import { Rule, RuleCheckResult } from "../../../../types/rule/rule";
+import type { Context } from "../../../../context/context";
+export declare class H1ExistsRule extends Rule {
+    private readonly parser;
+    constructor();
+    test(_code: string, ast?: unknown, _parentCtx?: Context): Promise<RuleCheckResult[]>;
+}
+//# sourceMappingURL=h1-exists-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-format/h1-exists-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"h1-exists-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/h1-exists-rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAU3D,qBAAa,YAAa,SAAQ,IAAI;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;;IAMlC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC;CAoBhC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/h1-exists-rule.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.H1ExistsRule = void 0;
+const markdown_1 = require("../../../../../tools/ast-parser/markdown");
+const rule_1 = require("../../../../types/rule/rule");
+const META = {
+    name: "md-h1-exists",
+    description: "Document must contain at least one level-1 heading",
+    messages: {
+        missing: "Document must contain a level-1 heading (# Title)",
+    },
+};
+class H1ExistsRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(_code, ast, _parentCtx) {
+        if (!ast) {
+            return [this.fail("missing", "")];
+        }
+        const doc = ast;
+        const headings = this.parser.getHeadings(doc);
+        const h1 = headings.find((h) => h.level === 1);
+        if (h1) {
+            return [
+                rule_1.RuleCheckResult.pass("Level-1 heading exists", h1.node.sourceRange ?? undefined),
+            ];
+        }
+        return [this.fail("missing", "", undefined, rule_1.RuleCheckResult.fromLine(1))];
+    }
+}
+exports.H1ExistsRule = H1ExistsRule;
+//# sourceMappingURL=h1-exists-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/h1-exists-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h1-exists-rule.js","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/h1-exists-rule.ts"],"names":[],"mappings":";;;AACA,uEAA0E;AAC1E,sDAAmF;AAGnF,MAAM,IAAI,GAAa;IACnB,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,oDAAoD;IACjE,QAAQ,EAAE;QACN,OAAO,EAAE,mDAAmD;KAC/D;CACJ,CAAC;AAEF,MAAa,YAAa,SAAQ,WAAI;IAGlC;QACI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAHX,WAAM,GAAG,IAAI,yBAAc,EAAE,CAAC;IAI/C,CAAC;IAEM,KAAK,CAAC,IAAI,CACb,KAAa,EACb,GAAa,EACb,UAAoB;QAEpB,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,GAAG,GAAG,GAAmB,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;QAE/C,IAAI,EAAE,EAAE,CAAC;YACL,OAAO;gBACH,sBAAe,CAAC,IAAI,CAChB,wBAAwB,EACxB,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,SAAS,CACnC;aACJ,CAAC;QACN,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,sBAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;CACJ;AA/BD,oCA+BC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/index.d.ts

@@ -0,0 +1,11 @@
+import type { Rule } from "../../../../types/rule/rule";
+export { FrontmatterCheckRule } from "./frontmatter/frontmatter-check-rule";
+export { LineLengthRule } from "./total/line-length-rule";
+export { NumberFormatRule } from "./total/number-format-rule";
+export { H1ExistsRule } from "./title/h1-exists-rule";
+export { ExampleSectionExistsRule } from "./example/example-section-exists-rule";
+export { BlankLineBetweenBlocksRule } from "./total/blank-line-between-blocks-rule";
+export { ArgumentSectionFormatRule } from "./arguments/argument-section-format-rule";
+export { AttributeSectionFormatRule } from "./attributes/attribute-section-format-rule";
+export declare const MARKDOWN_FORMAT_RULES: Rule[];
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-format/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAUxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAExF,eAAO,MAAM,qBAAqB,EAAE,IAAI,EASvC,CAAC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/index.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MARKDOWN_FORMAT_RULES = exports.AttributeSectionFormatRule = exports.ArgumentSectionFormatRule = exports.BlankLineBetweenBlocksRule = exports.ExampleSectionExistsRule = exports.H1ExistsRule = exports.NumberFormatRule = exports.LineLengthRule = exports.FrontmatterCheckRule = void 0;
+const frontmatter_check_rule_1 = require("./frontmatter/frontmatter-check-rule");
+const line_length_rule_1 = require("./total/line-length-rule");
+const number_format_rule_1 = require("./total/number-format-rule");
+const h1_exists_rule_1 = require("./title/h1-exists-rule");
+const example_section_exists_rule_1 = require("./example/example-section-exists-rule");
+const blank_line_between_blocks_rule_1 = require("./total/blank-line-between-blocks-rule");
+const argument_section_format_rule_1 = require("./arguments/argument-section-format-rule");
+const attribute_section_format_rule_1 = require("./attributes/attribute-section-format-rule");
+var frontmatter_check_rule_2 = require("./frontmatter/frontmatter-check-rule");
+Object.defineProperty(exports, "FrontmatterCheckRule", { enumerable: true, get: function () { return frontmatter_check_rule_2.FrontmatterCheckRule; } });
+var line_length_rule_2 = require("./total/line-length-rule");
+Object.defineProperty(exports, "LineLengthRule", { enumerable: true, get: function () { return line_length_rule_2.LineLengthRule; } });
+var number_format_rule_2 = require("./total/number-format-rule");
+Object.defineProperty(exports, "NumberFormatRule", { enumerable: true, get: function () { return number_format_rule_2.NumberFormatRule; } });
+var h1_exists_rule_2 = require("./title/h1-exists-rule");
+Object.defineProperty(exports, "H1ExistsRule", { enumerable: true, get: function () { return h1_exists_rule_2.H1ExistsRule; } });
+var example_section_exists_rule_2 = require("./example/example-section-exists-rule");
+Object.defineProperty(exports, "ExampleSectionExistsRule", { enumerable: true, get: function () { return example_section_exists_rule_2.ExampleSectionExistsRule; } });
+var blank_line_between_blocks_rule_2 = require("./total/blank-line-between-blocks-rule");
+Object.defineProperty(exports, "BlankLineBetweenBlocksRule", { enumerable: true, get: function () { return blank_line_between_blocks_rule_2.BlankLineBetweenBlocksRule; } });
+var argument_section_format_rule_2 = require("./arguments/argument-section-format-rule");
+Object.defineProperty(exports, "ArgumentSectionFormatRule", { enumerable: true, get: function () { return argument_section_format_rule_2.ArgumentSectionFormatRule; } });
+var attribute_section_format_rule_2 = require("./attributes/attribute-section-format-rule");
+Object.defineProperty(exports, "AttributeSectionFormatRule", { enumerable: true, get: function () { return attribute_section_format_rule_2.AttributeSectionFormatRule; } });
+exports.MARKDOWN_FORMAT_RULES = [
+    new frontmatter_check_rule_1.FrontmatterCheckRule(),
+    new line_length_rule_1.LineLengthRule(),
+    new number_format_rule_1.NumberFormatRule(),
+    new blank_line_between_blocks_rule_1.BlankLineBetweenBlocksRule(),
+    new h1_exists_rule_1.H1ExistsRule(),
+    new example_section_exists_rule_1.ExampleSectionExistsRule(),
+    new argument_section_format_rule_1.ArgumentSectionFormatRule(),
+    new attribute_section_format_rule_1.AttributeSectionFormatRule(),
+];
+//# sourceMappingURL=index.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/index.ts"],"names":[],"mappings":";;;AACA,iFAA4E;AAC5E,+DAA0D;AAC1D,mEAA8D;AAC9D,2DAAsD;AACtD,uFAAiF;AACjF,2FAAoF;AACpF,2FAAqF;AACrF,8FAAwF;AAExF,+EAA4E;AAAnE,8HAAA,oBAAoB,OAAA;AAC7B,6DAA0D;AAAjD,kHAAA,cAAc,OAAA;AACvB,iEAA8D;AAArD,sHAAA,gBAAgB,OAAA;AACzB,yDAAsD;AAA7C,8GAAA,YAAY,OAAA;AACrB,qFAAiF;AAAxE,uIAAA,wBAAwB,OAAA;AACjC,yFAAoF;AAA3E,4IAAA,0BAA0B,OAAA;AACnC,yFAAqF;AAA5E,yIAAA,yBAAyB,OAAA;AAClC,4FAAwF;AAA/E,2IAAA,0BAA0B,OAAA;AAEtB,QAAA,qBAAqB,GAAW;IACzC,IAAI,6CAAoB,EAAE;IAC1B,IAAI,iCAAc,EAAE;IACpB,IAAI,qCAAgB,EAAE;IACtB,IAAI,2DAA0B,EAAE;IAChC,IAAI,6BAAY,EAAE;IAClB,IAAI,sDAAwB,EAAE;IAC9B,IAAI,wDAAyB,EAAE;IAC/B,IAAI,0DAA0B,EAAE;CACnC,CAAC"}

package/dist/workflow/implement/resource-check/rules/markdown-format/line-length-rule.d.ts

@@ -0,0 +1,15 @@
+import { Rule, RuleCheckResult } from "../../../../types/rule/rule";
+import type { Context } from "../../../../context/context";
+export declare class LineLengthRule extends Rule {
+    private readonly parser;
+    constructor();
+    test(code: string, ast?: unknown, _parentCtx?: Context): Promise<RuleCheckResult[]>;
+    private buildSkipRanges;
+    private isInSkipRange;
+    /**
+     * Skip lines that cannot reasonably be wrapped:
+     * HTML anchor tags, pure URLs, markdown link definitions.
+     */
+    private shouldSkipLine;
+}
+//# sourceMappingURL=line-length-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-format/line-length-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-length-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/line-length-rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAqB3D,qBAAa,cAAe,SAAQ,IAAI;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;;IAMlC,IAAI,CACb,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC;IAwC7B,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAOzB"}

package/dist/workflow/implement/resource-check/rules/markdown-format/line-length-rule.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LineLengthRule = void 0;
+const markdown_1 = require("../../../../../tools/ast-parser/markdown");
+const rule_1 = require("../../../../types/rule/rule");
+const MAX_LINE_LENGTH = 120;
+const META = {
+    name: "md-line-length",
+    description: `Lines must not exceed ${MAX_LINE_LENGTH} columns; use soft line breaks to wrap`,
+    messages: {
+        tooLong: (line, length) => `Line ${line} exceeds ${MAX_LINE_LENGTH} columns (actual: ${length}). ` +
+            `Use a soft line break to wrap.`,
+        summary: (count) => `${count} line(s) exceed ${MAX_LINE_LENGTH} columns`,
+    },
+};
+class LineLengthRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(code, ast, _parentCtx) {
+        const lines = code.split(/\r?\n/);
+        const skipRanges = ast ? this.buildSkipRanges(ast) : [];
+        const violations = [];
+        for (let i = 0; i < lines.length; i++) {
+            const lineNum = i + 1;
+            const line = lines[i];
+            if (line.length <= MAX_LINE_LENGTH)
+                continue;
+            if (this.isInSkipRange(lineNum, skipRanges))
+                continue;
+            if (this.shouldSkipLine(line))
+                continue;
+            violations.push(new rule_1.RuleCheckResult(false, this.msg("tooLong", lineNum, line.length), line, line, [], rule_1.RuleCheckResult.fromLine(lineNum)));
+        }
+        if (violations.length === 0) {
+            return [rule_1.RuleCheckResult.pass("All lines are within length limit")];
+        }
+        return [
+            new rule_1.RuleCheckResult(false, this.msg("summary", violations.length), "", "", violations),
+        ];
+    }
+    buildSkipRanges(doc) {
+        const ranges = [];
+        const codeBlocks = this.parser.getCodeBlocks(doc);
+        for (const cb of codeBlocks) {
+            const sr = cb.node.sourceRange;
+            if (sr) {
+                ranges.push({ start: sr.start.line, end: sr.end.line });
+            }
+        }
+        const fm = this.parser.findFirst(doc, (n) => n.type === "frontmatter");
+        if (fm?.sourceRange) {
+            ranges.push({ start: fm.sourceRange.start.line, end: fm.sourceRange.end.line });
+        }
+        return ranges;
+    }
+    isInSkipRange(line, ranges) {
+        return ranges.some((r) => line >= r.start && line <= r.end);
+    }
+    /**
+     * Skip lines that cannot reasonably be wrapped:
+     * HTML anchor tags, pure URLs, markdown link definitions.
+     */
+    shouldSkipLine(line) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("<a ") && trimmed.endsWith(">"))
+            return true;
+        if (/^\[.+\]:\s*https?:\/\//.test(trimmed))
+            return true;
+        if (/^https?:\/\/\S+$/.test(trimmed))
+            return true;
+        return false;
+    }
+}
+exports.LineLengthRule = LineLengthRule;
+//# sourceMappingURL=line-length-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-format/line-length-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-length-rule.js","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-format/line-length-rule.ts"],"names":[],"mappings":"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"}