@greyworld/code-check-core 1.0.0

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

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

package/dist/workflow/implement/resource-check/rules/markdown-semantic/argument-section-semantic-rule.d.ts

@@ -0,0 +1,11 @@
+import { Rule, RuleCheckResult } from "../../../../types/rule/rule";
+import type { Context } from "../../../../context/context";
+export declare class ArgumentSectionSemanticRule extends Rule {
+    constructor();
+    test(_code: string, _ast?: unknown, parentCtx?: Context): Promise<RuleCheckResult[]>;
+    private checkOrdering;
+    private checkTagAlignment;
+    private checkDescriptionAlignment;
+    private checkCompleteness;
+}
+//# sourceMappingURL=argument-section-semantic-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-semantic/argument-section-semantic-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument-section-semantic-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/argument-section-semantic-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAmC3D,qBAAa,2BAA4B,SAAQ,IAAI;;IAKpC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC;IA0C7B,OAAO,CAAC,aAAa;IAmDrB,OAAO,CAAC,iBAAiB;IA0CzB,OAAO,CAAC,yBAAyB;IAiCjC,OAAO,CAAC,iBAAiB;CA+B5B"}

package/dist/workflow/implement/resource-check/rules/markdown-semantic/argument-section-semantic-rule.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgumentSectionSemanticRule = void 0;
+const rule_1 = require("../../../../types/rule/rule");
+const context_keys_1 = require("../../context-keys");
+const META = {
+    name: "argument-section-semantic",
+    description: "Arguments in the Markdown document must align with the provider schema " +
+        "(ordering, tags, completeness)",
+    messages: {
+        regionNotFirst: (line) => `Argument "region" must be the first argument, but found at line ${line}.`,
+        orderViolation: (name, line) => `Required argument "${name}" (line ${line}) appears after Optional arguments. ` +
+            `All Required arguments must precede Optional ones.`,
+        missingTag: (name, tag, line) => `Argument "${name}" (line ${line}): missing expected tag "${tag}".`,
+        extraTag: (name, tag, line) => `Argument "${name}" (line ${line}): unexpected tag "${tag}" (not in schema).`,
+        descriptionMismatch: (name, expected, actual, line) => `Argument "${name}" (line ${line}): description should start with "${expected}" ` +
+            `but found "${actual}".`,
+        missingInDoc: (name) => `Argument "${name}" is defined in schema but missing from the document.`,
+        extraInDoc: (name, line) => `Argument "${name}" (line ${line}) is documented but not found in the schema.`,
+    },
+};
+const TAG_SCHEMA_MAP = {
+    ForceNew: (f) => f.forceNew,
+    NonUpdatable: (f) => f.nonUpdatable,
+};
+class ArgumentSectionSemanticRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+    }
+    async test(_code, _ast, parentCtx) {
+        if (!parentCtx) {
+            return [rule_1.RuleCheckResult.pass("Context unavailable, rule skipped")];
+        }
+        const view = parentCtx.get(context_keys_1.CTX_SCHEMA_SEMANTIC_VIEW);
+        const docView = parentCtx.get(context_keys_1.CTX_DOC_SEMANTIC_VIEW);
+        if (!view || !docView) {
+            return [rule_1.RuleCheckResult.pass("Schema view or doc semantic view unavailable, rule skipped")];
+        }
+        if (view.arguments.size === 0) {
+            return [rule_1.RuleCheckResult.pass("No schema arguments, argument semantic check skipped")];
+        }
+        const docArgs = docView.argumentLists.flatMap((list) => list.arguments);
+        if (docArgs.length === 0) {
+            return [rule_1.RuleCheckResult.pass("No doc arguments found, existence checked by SectionExistenceRule")];
+        }
+        const failures = [];
+        this.checkOrdering(docArgs, view, failures);
+        this.checkTagAlignment(docArgs, view, failures);
+        this.checkDescriptionAlignment(docArgs, view, failures);
+        this.checkCompleteness(docArgs, view, failures);
+        if (failures.length === 0) {
+            return [rule_1.RuleCheckResult.pass("Argument section semantic checks passed")];
+        }
+        return [
+            new rule_1.RuleCheckResult(false, `Argument section has ${failures.length} semantic issue(s)`, "", "", failures),
+        ];
+    }
+    checkOrdering(docArgs, view, failures) {
+        if (docArgs.length === 0)
+            return;
+        const regionIndex = docArgs.findIndex((a) => a.name === "region");
+        if (regionIndex > 0) {
+            const line = getStartLine(docArgs[regionIndex]);
+            failures.push(this.fail("regionNotFirst", "", undefined, rule_1.RuleCheckResult.fromLine(line), line));
+        }
+        let firstOptionalIndex = -1;
+        for (let i = 0; i < docArgs.length; i++) {
+            const arg = docArgs[i];
+            if (arg.name === "region")
+                continue;
+            const field = view.arguments.get(arg.name);
+            if (!field)
+                continue;
+            if (field.required) {
+                if (firstOptionalIndex >= 0) {
+                    const line = getStartLine(arg);
+                    failures.push(this.fail("orderViolation", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, line));
+                }
+            }
+            else if (field.optional) {
+                if (firstOptionalIndex < 0) {
+                    firstOptionalIndex = i;
+                }
+            }
+        }
+    }
+    checkTagAlignment(docArgs, view, failures) {
+        for (const arg of docArgs) {
+            const field = view.arguments.get(arg.name);
+            if (!field)
+                continue;
+            const docTagSet = new Set(arg.tags);
+            for (const [tag, predicate] of Object.entries(TAG_SCHEMA_MAP)) {
+                const line = getStartLine(arg);
+                if (predicate(field) && !docTagSet.has(tag)) {
+                    failures.push(this.fail("missingTag", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, tag, line));
+                }
+                if (!predicate(field) && docTagSet.has(tag)) {
+                    failures.push(this.fail("extraTag", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, tag, line));
+                }
+            }
+        }
+    }
+    checkDescriptionAlignment(docArgs, view, failures) {
+        for (const arg of docArgs) {
+            const field = view.arguments.get(arg.name);
+            if (!field || !field.description)
+                continue;
+            const expectedPrefix = "Specifies " + lowercaseFirst(field.description);
+            const docDesc = arg.description;
+            if (!docDesc.startsWith(expectedPrefix)) {
+                const previewLen = expectedPrefix.length + 20;
+                const actualPreview = docDesc.length > previewLen
+                    ? docDesc.slice(0, previewLen) + "..."
+                    : docDesc;
+                const line = getStartLine(arg);
+                failures.push(this.fail("descriptionMismatch", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, expectedPrefix, actualPreview, line));
+            }
+        }
+    }
+    checkCompleteness(docArgs, view, failures) {
+        const docArgNames = new Set(docArgs.map((a) => a.name));
+        for (const [name] of view.arguments) {
+            if (!docArgNames.has(name)) {
+                failures.push(this.fail("missingInDoc", "", undefined, undefined, name));
+            }
+        }
+        for (const arg of docArgs) {
+            if (!view.arguments.has(arg.name)) {
+                const line = getStartLine(arg);
+                failures.push(this.fail("extraInDoc", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, line));
+            }
+        }
+    }
+}
+exports.ArgumentSectionSemanticRule = ArgumentSectionSemanticRule;
+function lowercaseFirst(s) {
+    if (s.length === 0)
+        return s;
+    return s[0].toLowerCase() + s.slice(1);
+}
+function getStartLine(arg) {
+    return arg.sourceRange?.start.line;
+}
+//# sourceMappingURL=argument-section-semantic-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-semantic/argument-section-semantic-rule.js.map

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

package/dist/workflow/implement/resource-check/rules/markdown-semantic/arguments/argument-section-semantic-rule.d.ts

@@ -0,0 +1,11 @@
+import { Rule, RuleCheckResult } from "../../../../../types/rule/rule";
+import type { Context } from "../../../../../context/context";
+export declare class ArgumentSectionSemanticRule extends Rule {
+    constructor();
+    test(_code: string, _ast?: unknown, parentCtx?: Context): Promise<RuleCheckResult[]>;
+    private checkOrdering;
+    private checkTagAlignment;
+    private checkDescriptionAlignment;
+    private checkCompleteness;
+}
+//# sourceMappingURL=argument-section-semantic-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-semantic/arguments/argument-section-semantic-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument-section-semantic-rule.d.ts","sourceRoot":"","sources":["../../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/arguments/argument-section-semantic-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAmC9D,qBAAa,2BAA4B,SAAQ,IAAI;;IAKpC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC;IA0C7B,OAAO,CAAC,aAAa;IAmDrB,OAAO,CAAC,iBAAiB;IA0CzB,OAAO,CAAC,yBAAyB;IAiCjC,OAAO,CAAC,iBAAiB;CA+B5B"}

package/dist/workflow/implement/resource-check/rules/markdown-semantic/arguments/argument-section-semantic-rule.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgumentSectionSemanticRule = void 0;
+const rule_1 = require("../../../../../types/rule/rule");
+const context_keys_1 = require("../../../context-keys");
+const META = {
+    name: "argument-section-semantic",
+    description: "Arguments in the Markdown document must align with the provider schema " +
+        "(ordering, tags, completeness)",
+    messages: {
+        regionNotFirst: (line) => `Argument "region" must be the first argument, but found at line ${line}.`,
+        orderViolation: (name, line) => `Required argument "${name}" (line ${line}) appears after Optional arguments. ` +
+            `All Required arguments must precede Optional ones.`,
+        missingTag: (name, tag, line) => `Argument "${name}" (line ${line}): missing expected tag "${tag}".`,
+        extraTag: (name, tag, line) => `Argument "${name}" (line ${line}): unexpected tag "${tag}" (not in schema).`,
+        descriptionMismatch: (name, expected, actual, line) => `Argument "${name}" (line ${line}): description should start with "${expected}" ` +
+            `but found "${actual}".`,
+        missingInDoc: (name) => `Argument "${name}" is defined in schema but missing from the document.`,
+        extraInDoc: (name, line) => `Argument "${name}" (line ${line}) is documented but not found in the schema.`,
+    },
+};
+const TAG_SCHEMA_MAP = {
+    ForceNew: (f) => f.forceNew && !f.nonUpdatable,
+    NonUpdatable: (f) => f.nonUpdatable,
+};
+class ArgumentSectionSemanticRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+    }
+    async test(_code, _ast, parentCtx) {
+        if (!parentCtx) {
+            return [rule_1.RuleCheckResult.pass("Context unavailable, rule skipped")];
+        }
+        const view = parentCtx.get(context_keys_1.CTX_SCHEMA_SEMANTIC_VIEW);
+        const docView = parentCtx.get(context_keys_1.CTX_DOC_SEMANTIC_VIEW);
+        if (!view || !docView) {
+            return [rule_1.RuleCheckResult.pass("Schema view or doc semantic view unavailable, rule skipped")];
+        }
+        if (view.arguments.size === 0) {
+            return [rule_1.RuleCheckResult.pass("No schema arguments, argument semantic check skipped")];
+        }
+        const docArgs = docView.argumentLists.flatMap((list) => list.arguments);
+        if (docArgs.length === 0) {
+            return [rule_1.RuleCheckResult.pass("No doc arguments found, existence checked by SectionExistenceRule")];
+        }
+        const failures = [];
+        this.checkOrdering(docArgs, view, failures);
+        this.checkTagAlignment(docArgs, view, failures);
+        this.checkDescriptionAlignment(docArgs, view, failures);
+        this.checkCompleteness(docArgs, view, failures);
+        if (failures.length === 0) {
+            return [rule_1.RuleCheckResult.pass("Argument section semantic checks passed")];
+        }
+        return [
+            new rule_1.RuleCheckResult(false, `Argument section has ${failures.length} semantic issue(s)`, "", "", failures),
+        ];
+    }
+    checkOrdering(docArgs, view, failures) {
+        if (docArgs.length === 0)
+            return;
+        const regionIndex = docArgs.findIndex((a) => a.name === "region");
+        if (regionIndex > 0) {
+            const line = getStartLine(docArgs[regionIndex]);
+            failures.push(this.fail("regionNotFirst", "", undefined, rule_1.RuleCheckResult.fromLine(line), line));
+        }
+        let firstOptionalIndex = -1;
+        for (let i = 0; i < docArgs.length; i++) {
+            const arg = docArgs[i];
+            if (arg.name === "region")
+                continue;
+            const field = view.arguments.get(arg.name);
+            if (!field)
+                continue;
+            if (field.required) {
+                if (firstOptionalIndex >= 0) {
+                    const line = getStartLine(arg);
+                    failures.push(this.fail("orderViolation", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, line));
+                }
+            }
+            else if (field.optional) {
+                if (firstOptionalIndex < 0) {
+                    firstOptionalIndex = i;
+                }
+            }
+        }
+    }
+    checkTagAlignment(docArgs, view, failures) {
+        for (const arg of docArgs) {
+            const field = view.arguments.get(arg.name);
+            if (!field)
+                continue;
+            const docTagSet = new Set(arg.tags);
+            for (const [tag, predicate] of Object.entries(TAG_SCHEMA_MAP)) {
+                const line = getStartLine(arg);
+                if (predicate(field) && !docTagSet.has(tag)) {
+                    failures.push(this.fail("missingTag", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, tag, line));
+                }
+                if (!predicate(field) && docTagSet.has(tag)) {
+                    failures.push(this.fail("extraTag", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, tag, line));
+                }
+            }
+        }
+    }
+    checkDescriptionAlignment(docArgs, view, failures) {
+        for (const arg of docArgs) {
+            const field = view.arguments.get(arg.name);
+            if (!field || !field.description)
+                continue;
+            const expectedPrefix = "Specifies " + lowercaseFirst(field.description);
+            const docDesc = arg.description;
+            if (!docDesc.startsWith(expectedPrefix)) {
+                const previewLen = expectedPrefix.length + 20;
+                const actualPreview = docDesc.length > previewLen
+                    ? docDesc.slice(0, previewLen) + "..."
+                    : docDesc;
+                const line = getStartLine(arg);
+                failures.push(this.fail("descriptionMismatch", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, expectedPrefix, actualPreview, line));
+            }
+        }
+    }
+    checkCompleteness(docArgs, view, failures) {
+        const docArgNames = new Set(docArgs.map((a) => a.name));
+        for (const [name] of view.arguments) {
+            if (!docArgNames.has(name)) {
+                failures.push(this.fail("missingInDoc", "", undefined, undefined, name));
+            }
+        }
+        for (const arg of docArgs) {
+            if (!view.arguments.has(arg.name)) {
+                const line = getStartLine(arg);
+                failures.push(this.fail("extraInDoc", "", undefined, rule_1.RuleCheckResult.fromLine(line), arg.name, line));
+            }
+        }
+    }
+}
+exports.ArgumentSectionSemanticRule = ArgumentSectionSemanticRule;
+function lowercaseFirst(s) {
+    if (s.length === 0)
+        return s;
+    return s[0].toLowerCase() + s.slice(1);
+}
+function getStartLine(arg) {
+    return arg.sourceRange?.start.line;
+}
+//# sourceMappingURL=argument-section-semantic-rule.js.map

package/dist/workflow/implement/resource-check/rules/markdown-semantic/arguments/argument-section-semantic-rule.js.map

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

package/dist/workflow/implement/resource-check/rules/markdown-semantic/attribute-section-semantic-rule.d.ts

@@ -0,0 +1,9 @@
+import { Rule, RuleCheckResult } from "../../../../types/rule/rule";
+import type { Context } from "../../../../context/context";
+export declare class AttributeSectionSemanticRule extends Rule {
+    constructor();
+    test(_code: string, _ast?: unknown, parentCtx?: Context): Promise<RuleCheckResult[]>;
+    private checkCompleteness;
+    private checkDescriptionAlignment;
+}
+//# sourceMappingURL=attribute-section-semantic-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-semantic/attribute-section-semantic-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-section-semantic-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/attribute-section-semantic-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAqB3D,qBAAa,4BAA6B,SAAQ,IAAI;;IAKrC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC;IA0C7B,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,yBAAyB;CAgCpC"}

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

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttributeSectionSemanticRule = void 0;
+const rule_1 = require("../../../../types/rule/rule");
+const context_keys_1 = require("../../context-keys");
+const META = {
+    name: "attribute-section-semantic",
+    description: "Attributes in the Markdown document must align with the provider schema " +
+        "(completeness and consistency)",
+    messages: {
+        missingInDoc: (name) => `Attribute "${name}" is defined in schema but missing from the document.`,
+        extraInDoc: (name, line) => `Attribute "${name}" (line ${line}) is documented but not found in the schema.`,
+        descriptionMismatch: (name, expected, actual, line) => `Attribute "${name}" (line ${line}): description should be "${expected}" ` +
+            `but found "${actual}".`,
+    },
+};
+class AttributeSectionSemanticRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+    }
+    async test(_code, _ast, parentCtx) {
+        if (!parentCtx) {
+            return [rule_1.RuleCheckResult.pass("Context unavailable, rule skipped")];
+        }
+        const view = parentCtx.get(context_keys_1.CTX_SCHEMA_SEMANTIC_VIEW);
+        const docView = parentCtx.get(context_keys_1.CTX_DOC_SEMANTIC_VIEW);
+        if (!view || !docView) {
+            return [rule_1.RuleCheckResult.pass("Schema view or doc semantic view unavailable, rule skipped")];
+        }
+        if (view.attributes.size === 0) {
+            return [rule_1.RuleCheckResult.pass("No schema attributes, attribute semantic check skipped")];
+        }
+        const docAttrs = docView.attributeLists.flatMap((list) => list.attributes);
+        if (docAttrs.length === 0) {
+            return [rule_1.RuleCheckResult.pass("No doc attributes found, existence checked by SectionExistenceRule")];
+        }
+        const failures = [];
+        this.checkCompleteness(docAttrs, view, failures);
+        this.checkDescriptionAlignment(docAttrs, view, failures);
+        if (failures.length === 0) {
+            return [rule_1.RuleCheckResult.pass("Attribute section semantic checks passed")];
+        }
+        return [
+            new rule_1.RuleCheckResult(false, `Attribute section has ${failures.length} semantic issue(s)`, "", "", failures),
+        ];
+    }
+    checkCompleteness(docAttrs, view, failures) {
+        const docAttrNames = new Set(docAttrs.map((a) => a.name));
+        for (const [name] of view.attributes) {
+            if (!docAttrNames.has(name)) {
+                failures.push(this.fail("missingInDoc", "", undefined, undefined, name));
+            }
+        }
+        for (const attr of docAttrs) {
+            if (!view.attributes.has(attr.name)) {
+                const line = getStartLine(attr);
+                failures.push(this.fail("extraInDoc", "", undefined, rule_1.RuleCheckResult.fromLine(line), attr.name, line));
+            }
+        }
+    }
+    checkDescriptionAlignment(docAttrs, view, failures) {
+        for (const attr of docAttrs) {
+            const field = view.attributes.get(attr.name);
+            if (!field || !field.description)
+                continue;
+            const expected = field.description.trim();
+            const actual = attr.description.trim();
+            if (expected && actual !== expected) {
+                const previewLen = Math.min(expected.length + 20, 80);
+                const actualPreview = actual.length > previewLen
+                    ? actual.slice(0, previewLen) + "..."
+                    : actual;
+                const line = getStartLine(attr);
+                failures.push(this.fail("descriptionMismatch", "", undefined, rule_1.RuleCheckResult.fromLine(line), attr.name, expected, actualPreview, line));
+            }
+        }
+    }
+}
+exports.AttributeSectionSemanticRule = AttributeSectionSemanticRule;
+function getStartLine(attr) {
+    return attr.sourceRange?.start.line;
+}
+//# sourceMappingURL=attribute-section-semantic-rule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-section-semantic-rule.js","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/attribute-section-semantic-rule.ts"],"names":[],"mappings":";;;AAAA,sDAAmF;AAInF,qDAAqF;AAErF,MAAM,IAAI,GAAa;IACnB,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACP,0EAA0E;QAC1E,gCAAgC;IACpC,QAAQ,EAAE;QACN,YAAY,EAAE,CAAC,IAAa,EAAE,EAAE,CAC5B,cAAc,IAAI,uDAAuD;QAC7E,UAAU,EAAE,CAAC,IAAa,EAAE,IAAa,EAAE,EAAE,CACzC,cAAc,IAAI,WAAW,IAAI,8CAA8C;QACnF,mBAAmB,EAAE,CAAC,IAAa,EAAE,QAAiB,EAAE,MAAe,EAAE,IAAa,EAAE,EAAE,CACtF,cAAc,IAAI,WAAW,IAAI,6BAA6B,QAAQ,IAAI;YAC1E,cAAc,MAAM,IAAI;KAC/B;CACJ,CAAC;AAEF,MAAa,4BAA6B,SAAQ,WAAI;IAClD;QACI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,IAAI,CACb,KAAa,EACb,IAAc,EACd,SAAmB;QAEnB,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,CAAC,sBAAe,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAqB,uCAAwB,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAkB,oCAAqB,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,sBAAe,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC,CAAC;QAChG,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,sBAAe,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,sBAAe,CAAC,IAAI,CACxB,oEAAoE,CACvE,CAAC,CAAC;QACP,CAAC;QAED,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,sBAAe,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO;YACH,IAAI,sBAAe,CACf,KAAK,EACL,yBAAyB,QAAQ,CAAC,MAAM,oBAAoB,EAC5D,EAAE,EACF,EAAE,EACF,QAAQ,CACX;SACJ,CAAC;IACN,CAAC;IAEO,iBAAiB,CACrB,QAAqB,EACrB,IAAwB,EACxB,QAA2B;QAE3B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAE1D,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAC5D,CAAC;YACN,CAAC;QACL,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;gBAChC,QAAQ,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,CACL,YAAY,EACZ,EAAE,EACF,SAAS,EACT,sBAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC9B,IAAI,CAAC,IAAI,EACT,IAAI,CACP,CACJ,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAEO,yBAAyB,CAC7B,QAAqB,EACrB,IAAwB,EACxB,QAA2B;QAE3B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,WAAW;gBAAE,SAAS;YAE3C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,QAAQ,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;gBACtD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,GAAG,UAAU;oBAC5C,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,KAAK;oBACrC,CAAC,CAAC,MAAM,CAAC;gBACb,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;gBAChC,QAAQ,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,CACL,qBAAqB,EACrB,EAAE,EACF,SAAS,EACT,sBAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC9B,IAAI,CAAC,IAAI,EACT,QAAQ,EACR,aAAa,EACb,IAAI,CACP,CACJ,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AAnHD,oEAmHC;AAED,SAAS,YAAY,CAAC,IAAe;IACjC,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC;AACxC,CAAC"}

package/dist/workflow/implement/resource-check/rules/markdown-semantic/attributes/attribute-section-semantic-rule.d.ts

@@ -0,0 +1,9 @@
+import { Rule, RuleCheckResult } from "../../../../../types/rule/rule";
+import type { Context } from "../../../../../context/context";
+export declare class AttributeSectionSemanticRule extends Rule {
+    constructor();
+    test(_code: string, _ast?: unknown, parentCtx?: Context): Promise<RuleCheckResult[]>;
+    private checkCompleteness;
+    private checkDescriptionAlignment;
+}
+//# sourceMappingURL=attribute-section-semantic-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/markdown-semantic/attributes/attribute-section-semantic-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-section-semantic-rule.d.ts","sourceRoot":"","sources":["../../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/attributes/attribute-section-semantic-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAqB9D,qBAAa,4BAA6B,SAAQ,IAAI;;IAKrC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC;IA0C7B,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,yBAAyB;CAgCpC"}

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

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttributeSectionSemanticRule = void 0;
+const rule_1 = require("../../../../../types/rule/rule");
+const context_keys_1 = require("../../../context-keys");
+const META = {
+    name: "attribute-section-semantic",
+    description: "Attributes in the Markdown document must align with the provider schema " +
+        "(completeness and consistency)",
+    messages: {
+        missingInDoc: (name) => `Attribute "${name}" is defined in schema but missing from the document.`,
+        extraInDoc: (name, line) => `Attribute "${name}" (line ${line}) is documented but not found in the schema.`,
+        descriptionMismatch: (name, expected, actual, line) => `Attribute "${name}" (line ${line}): description should be "${expected}" ` +
+            `but found "${actual}".`,
+    },
+};
+class AttributeSectionSemanticRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+    }
+    async test(_code, _ast, parentCtx) {
+        if (!parentCtx) {
+            return [rule_1.RuleCheckResult.pass("Context unavailable, rule skipped")];
+        }
+        const view = parentCtx.get(context_keys_1.CTX_SCHEMA_SEMANTIC_VIEW);
+        const docView = parentCtx.get(context_keys_1.CTX_DOC_SEMANTIC_VIEW);
+        if (!view || !docView) {
+            return [rule_1.RuleCheckResult.pass("Schema view or doc semantic view unavailable, rule skipped")];
+        }
+        if (view.attributes.size === 0) {
+            return [rule_1.RuleCheckResult.pass("No schema attributes, attribute semantic check skipped")];
+        }
+        const docAttrs = docView.attributeLists.flatMap((list) => list.attributes);
+        if (docAttrs.length === 0) {
+            return [rule_1.RuleCheckResult.pass("No doc attributes found, existence checked by SectionExistenceRule")];
+        }
+        const failures = [];
+        this.checkCompleteness(docAttrs, view, failures);
+        this.checkDescriptionAlignment(docAttrs, view, failures);
+        if (failures.length === 0) {
+            return [rule_1.RuleCheckResult.pass("Attribute section semantic checks passed")];
+        }
+        return [
+            new rule_1.RuleCheckResult(false, `Attribute section has ${failures.length} semantic issue(s)`, "", "", failures),
+        ];
+    }
+    checkCompleteness(docAttrs, view, failures) {
+        const docAttrNames = new Set(docAttrs.map((a) => a.name));
+        for (const [name] of view.attributes) {
+            if (!docAttrNames.has(name)) {
+                failures.push(this.fail("missingInDoc", "", undefined, undefined, name));
+            }
+        }
+        for (const attr of docAttrs) {
+            if (!view.attributes.has(attr.name)) {
+                const line = getStartLine(attr);
+                failures.push(this.fail("extraInDoc", "", undefined, rule_1.RuleCheckResult.fromLine(line), attr.name, line));
+            }
+        }
+    }
+    checkDescriptionAlignment(docAttrs, view, failures) {
+        for (const attr of docAttrs) {
+            const field = view.attributes.get(attr.name);
+            if (!field || !field.description)
+                continue;
+            const expected = field.description.trim();
+            const actual = attr.description.trim();
+            if (expected && actual !== expected) {
+                const previewLen = Math.min(expected.length + 20, 80);
+                const actualPreview = actual.length > previewLen
+                    ? actual.slice(0, previewLen) + "..."
+                    : actual;
+                const line = getStartLine(attr);
+                failures.push(this.fail("descriptionMismatch", "", undefined, rule_1.RuleCheckResult.fromLine(line), attr.name, expected, actualPreview, line));
+            }
+        }
+    }
+}
+exports.AttributeSectionSemanticRule = AttributeSectionSemanticRule;
+function getStartLine(attr) {
+    return attr.sourceRange?.start.line;
+}
+//# sourceMappingURL=attribute-section-semantic-rule.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { Rule } from "../../../../types/rule/rule";
+import { SectionExistenceRule } from "./total/section-existence-rule";
+import { ArgumentSectionSemanticRule } from "./arguments/argument-section-semantic-rule";
+import { AttributeSectionSemanticRule } from "./attributes/attribute-section-semantic-rule";
+export { SectionExistenceRule, ArgumentSectionSemanticRule, AttributeSectionSemanticRule, };
+export declare const MARKDOWN_SEMANTIC_RULES: Rule[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,8CAA8C,CAAC;AAE5F,OAAO,EACH,oBAAoB,EACpB,2BAA2B,EAC3B,4BAA4B,GAC/B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,IAAI,EAIzC,CAAC"}

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MARKDOWN_SEMANTIC_RULES = exports.AttributeSectionSemanticRule = exports.ArgumentSectionSemanticRule = exports.SectionExistenceRule = void 0;
+const section_existence_rule_1 = require("./total/section-existence-rule");
+Object.defineProperty(exports, "SectionExistenceRule", { enumerable: true, get: function () { return section_existence_rule_1.SectionExistenceRule; } });
+const argument_section_semantic_rule_1 = require("./arguments/argument-section-semantic-rule");
+Object.defineProperty(exports, "ArgumentSectionSemanticRule", { enumerable: true, get: function () { return argument_section_semantic_rule_1.ArgumentSectionSemanticRule; } });
+const attribute_section_semantic_rule_1 = require("./attributes/attribute-section-semantic-rule");
+Object.defineProperty(exports, "AttributeSectionSemanticRule", { enumerable: true, get: function () { return attribute_section_semantic_rule_1.AttributeSectionSemanticRule; } });
+exports.MARKDOWN_SEMANTIC_RULES = [
+    new section_existence_rule_1.SectionExistenceRule(),
+    new argument_section_semantic_rule_1.ArgumentSectionSemanticRule(),
+    new attribute_section_semantic_rule_1.AttributeSectionSemanticRule(),
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/index.ts"],"names":[],"mappings":";;;AACA,2EAAsE;AAKlE,qGALK,6CAAoB,OAKL;AAJxB,+FAAyF;AAKrF,4GALK,4DAA2B,OAKL;AAJ/B,kGAA4F;AAKxF,6GALK,8DAA4B,OAKL;AAGnB,QAAA,uBAAuB,GAAW;IAC3C,IAAI,6CAAoB,EAAE;IAC1B,IAAI,4DAA2B,EAAE;IACjC,IAAI,8DAA4B,EAAE;CACrC,CAAC"}

package/dist/workflow/implement/resource-check/rules/markdown-semantic/section-existence-rule.d.ts

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