@greyworld/code-check-core 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-existence-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/section-existence-rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAyD3D,qBAAa,oBAAqB,SAAQ,IAAI;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;;IAMlC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,OAAO,EACb,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC;IA0D7B,OAAO,CAAC,cAAc;CAmCzB"}

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

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SectionExistenceRule = void 0;
+const markdown_1 = require("../../../../../tools/ast-parser/markdown");
+const rule_1 = require("../../../../types/rule/rule");
+const context_keys_1 = require("../../context-keys");
+const SECTION_EXPECTATIONS = [
+    {
+        title: "Argument Reference",
+        level: 2,
+        shouldExist: (v) => v.arguments.size > 0,
+        reason: (v) => `schema has ${v.arguments.size} argument(s)`,
+        introLine: "The following arguments are supported:",
+    },
+    {
+        title: "Attribute Reference",
+        level: 2,
+        shouldExist: (v) => v.attributes.size > 0,
+        reason: (v) => `schema has ${v.attributes.size} attribute(s)`,
+        introLine: "In addition to all arguments above, the following attributes are exported:",
+    },
+    {
+        title: "Timeouts",
+        level: 2,
+        shouldExist: (v) => v.timeouts !== null,
+        reason: () => "schema defines timeouts",
+    },
+    {
+        title: "Import",
+        level: 2,
+        shouldExist: (v) => v.importInfo.importable,
+        reason: () => "schema is importable",
+    },
+];
+const META = {
+    name: "section-existence",
+    description: "Markdown sections must exist if and only if the schema has corresponding data",
+    messages: {
+        missing: (title, reason) => `Section "## ${title}" is missing but expected: ${reason}.`,
+        unexpected: (title) => `Section "## ${title}" exists but has no corresponding schema data.`,
+        introMismatch: (title, expected, actual) => `Section "## ${title}" intro line should be "${expected}" but found "${actual}".`,
+        introMissing: (title, expected) => `Section "## ${title}" is missing the required intro line: "${expected}".`,
+    },
+};
+class SectionExistenceRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(_code, ast, parentCtx) {
+        if (!ast || !parentCtx) {
+            return [rule_1.RuleCheckResult.pass("AST or context unavailable, rule skipped")];
+        }
+        const view = parentCtx.get(context_keys_1.CTX_SCHEMA_SEMANTIC_VIEW);
+        if (!view) {
+            return [rule_1.RuleCheckResult.pass("Schema semantic view unavailable, rule skipped")];
+        }
+        const doc = ast;
+        const results = [];
+        for (const expectation of SECTION_EXPECTATIONS) {
+            const section = this.parser.getSection(doc, expectation.level, expectation.title);
+            const exists = section !== null && section !== undefined;
+            const expected = expectation.shouldExist(view);
+            if (expected && !exists) {
+                results.push(this.fail("missing", "", undefined, undefined, expectation.title, expectation.reason(view)));
+            }
+            else if (!expected && exists) {
+                const startLine = section?.[0]?.sourceRange?.start.line;
+                results.push(this.fail("unexpected", "", undefined, rule_1.RuleCheckResult.fromLine(startLine), expectation.title));
+            }
+            else if (expected && exists && expectation.introLine) {
+                const introResult = this.checkIntroLine(section, expectation.title, expectation.introLine);
+                results.push(introResult);
+            }
+            else {
+                const label = expected ? "present as expected" : "absent as expected";
+                results.push(rule_1.RuleCheckResult.pass(`Section "## ${expectation.title}" is ${label}`));
+            }
+        }
+        return results;
+    }
+    checkIntroLine(sectionNodes, title, expectedIntro) {
+        const firstParagraph = sectionNodes.find((n) => n.type === "paragraph");
+        if (!firstParagraph) {
+            return this.fail("introMissing", "", undefined, undefined, title, expectedIntro);
+        }
+        const actualText = this.parser.getTextContent(firstParagraph).trim();
+        if (actualText === expectedIntro) {
+            return rule_1.RuleCheckResult.pass(`Section "## ${title}" is present with correct intro line`);
+        }
+        const startLine = firstParagraph.sourceRange?.start.line;
+        return this.fail("introMismatch", "", undefined, rule_1.RuleCheckResult.fromLine(startLine), title, expectedIntro, actualText);
+    }
+}
+exports.SectionExistenceRule = SectionExistenceRule;
+//# sourceMappingURL=section-existence-rule.js.map

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

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

package/dist/workflow/implement/resource-check/rules/markdown-semantic/total/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-existence-rule.d.ts","sourceRoot":"","sources":["../../../../../../../src/workflow/implement/resource-check/rules/markdown-semantic/total/section-existence-rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAiB,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAkE9D,qBAAa,oBAAqB,SAAQ,IAAI;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;;IAMlC,IAAI,CACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,OAAO,EACb,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC;IAmE7B,OAAO,CAAC,cAAc;CAmCzB"}

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

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SectionExistenceRule = void 0;
+const markdown_1 = require("../../../../../../tools/ast-parser/markdown");
+const rule_1 = require("../../../../../types/rule/rule");
+const context_keys_1 = require("../../../context-keys");
+const SECTION_EXPECTATIONS = [
+    {
+        title: "Argument Reference",
+        level: 2,
+        shouldExist: (v) => v.arguments.size > 0,
+        reason: (v) => `schema has ${v.arguments.size} argument(s)`,
+        schemaFields: (v) => [...v.arguments.keys()],
+        docFields: (d) => d.argumentLists.flatMap((l) => l.arguments.map((a) => a.name)),
+        introLine: "The following arguments are supported:",
+    },
+    {
+        title: "Attribute Reference",
+        level: 2,
+        shouldExist: (v) => v.attributes.size > 0,
+        reason: (v) => `schema has ${v.attributes.size} attribute(s)`,
+        schemaFields: (v) => [...v.attributes.keys()],
+        docFields: (d) => d.attributeLists.flatMap((l) => l.attributes.map((a) => a.name)),
+        introLine: "In addition to all arguments above, the following attributes are exported:",
+    },
+    {
+        title: "Timeouts",
+        level: 2,
+        shouldExist: (v) => v.timeouts !== null,
+        reason: () => "schema defines timeouts",
+    },
+    {
+        title: "Import",
+        level: 2,
+        shouldExist: (v) => v.importInfo.importable,
+        reason: () => "schema is importable",
+    },
+];
+const META = {
+    name: "section-existence",
+    description: "Markdown sections must exist if and only if the schema has corresponding data",
+    messages: {
+        missing: (title, reason, fields) => `Section "## ${title}" is missing but expected: ${reason}.` +
+            (fields ? ` Schema fields: [${fields}]` : ""),
+        unexpected: (title, fields) => `Section "## ${title}" exists but has no corresponding schema data.` +
+            (fields ? ` Doc fields to remove: [${fields}]` : ""),
+        introMismatch: (title, expected, actual) => `Section "## ${title}" intro line should be "${expected}" but found "${actual}".`,
+        introMissing: (title, expected) => `Section "## ${title}" is missing the required intro line: "${expected}".`,
+    },
+};
+class SectionExistenceRule extends rule_1.Rule {
+    constructor() {
+        super(META, "markdown");
+        this.parser = new markdown_1.MarkdownParser();
+    }
+    async test(_code, ast, parentCtx) {
+        if (!ast || !parentCtx) {
+            return [rule_1.RuleCheckResult.pass("AST or context unavailable, rule skipped")];
+        }
+        const view = parentCtx.get(context_keys_1.CTX_SCHEMA_SEMANTIC_VIEW);
+        if (!view) {
+            return [rule_1.RuleCheckResult.pass("Schema semantic view unavailable, rule skipped")];
+        }
+        const docView = parentCtx.get(context_keys_1.CTX_DOC_SEMANTIC_VIEW);
+        const doc = ast;
+        const results = [];
+        for (const expectation of SECTION_EXPECTATIONS) {
+            const section = this.parser.getSection(doc, expectation.level, expectation.title);
+            const exists = section !== null && section !== undefined;
+            const expected = expectation.shouldExist(view);
+            if (expected && !exists) {
+                const schemaFieldList = expectation.schemaFields
+                    ? expectation.schemaFields(view).join(", ")
+                    : "";
+                results.push(this.fail("missing", "", undefined, undefined, expectation.title, expectation.reason(view), schemaFieldList));
+            }
+            else if (!expected && exists) {
+                const startLine = section?.[0]?.sourceRange?.start.line;
+                const docFieldList = (expectation.docFields && docView)
+                    ? expectation.docFields(docView).join(", ")
+                    : "";
+                results.push(this.fail("unexpected", "", undefined, rule_1.RuleCheckResult.fromLine(startLine), expectation.title, docFieldList));
+            }
+            else if (expected && exists && expectation.introLine) {
+                const introResult = this.checkIntroLine(section, expectation.title, expectation.introLine);
+                results.push(introResult);
+            }
+            else {
+                const label = expected ? "present as expected" : "absent as expected";
+                results.push(rule_1.RuleCheckResult.pass(`Section "## ${expectation.title}" is ${label}`));
+            }
+        }
+        return results;
+    }
+    checkIntroLine(sectionNodes, title, expectedIntro) {
+        const firstParagraph = sectionNodes.find((n) => n.type === "paragraph");
+        if (!firstParagraph) {
+            return this.fail("introMissing", "", undefined, undefined, title, expectedIntro);
+        }
+        const actualText = this.parser.getTextContent(firstParagraph).trim();
+        if (actualText === expectedIntro) {
+            return rule_1.RuleCheckResult.pass(`Section "## ${title}" is present with correct intro line`);
+        }
+        const startLine = firstParagraph.sourceRange?.start.line;
+        return this.fail("introMismatch", "", undefined, rule_1.RuleCheckResult.fromLine(startLine), title, expectedIntro, actualText);
+    }
+}
+exports.SectionExistenceRule = SectionExistenceRule;
+//# sourceMappingURL=section-existence-rule.js.map

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

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

package/dist/workflow/implement/resource-check/rules/stage-placeholder-rule.d.ts

@@ -0,0 +1,19 @@
+import { Rule, RuleCheckResult } from "../../../types/rule/rule";
+import type { Context } from "../../../context/context";
+export interface StagePlaceholderOptions {
+    name: string;
+    description: string;
+    message: string;
+    success?: boolean;
+    rangeLine?: number;
+}
+/**
+ * Placeholder rule used during staged resource-check flow.
+ * Keeps the report contract stable while real checks are pending.
+ */
+export declare class StagePlaceholderRule extends Rule {
+    private readonly opts;
+    constructor(opts: StagePlaceholderOptions);
+    test(_code: string, _ast?: unknown, _parentCtx?: Context): Promise<RuleCheckResult[]>;
+}
+//# sourceMappingURL=stage-placeholder-rule.d.ts.map

package/dist/workflow/implement/resource-check/rules/stage-placeholder-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-placeholder-rule.d.ts","sourceRoot":"","sources":["../../../../../src/workflow/implement/resource-check/rules/stage-placeholder-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAY,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,IAAI;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;gBAEnC,IAAI,EAAE,uBAAuB;IAK5B,IAAI,CACb,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC;CAShC"}

package/dist/workflow/implement/resource-check/rules/stage-placeholder-rule.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StagePlaceholderRule = void 0;
+const rule_1 = require("../../../types/rule/rule");
+function createMeta(opts) {
+    return {
+        name: opts.name,
+        description: opts.description,
+        messages: { result: opts.message },
+    };
+}
+/**
+ * Placeholder rule used during staged resource-check flow.
+ * Keeps the report contract stable while real checks are pending.
+ */
+class StagePlaceholderRule extends rule_1.Rule {
+    constructor(opts) {
+        super(createMeta(opts), "code");
+        this.opts = opts;
+    }
+    async test(_code, _ast, _parentCtx) {
+        const success = this.opts.success ?? true;
+        const range = rule_1.RuleCheckResult.fromLine(this.opts.rangeLine ?? 1);
+        if (success) {
+            return [rule_1.RuleCheckResult.pass(this.msg("result"), range)];
+        }
+        return [this.fail("result", "", undefined, range)];
+    }
+}
+exports.StagePlaceholderRule = StagePlaceholderRule;
+//# sourceMappingURL=stage-placeholder-rule.js.map

package/dist/workflow/implement/resource-check/rules/stage-placeholder-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-placeholder-rule.js","sourceRoot":"","sources":["../../../../../src/workflow/implement/resource-check/rules/stage-placeholder-rule.ts"],"names":[],"mappings":";;;AAAA,mDAA2E;AAW3E,SAAS,UAAU,CAAC,IAA6B;IAC7C,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;KACrC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAa,oBAAqB,SAAQ,WAAI;IAG1C,YAAY,IAA6B;QACrC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,IAAI,CACb,KAAa,EACb,IAAc,EACd,UAAoB;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QAC1C,MAAM,KAAK,GAAG,sBAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;QAEjE,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,sBAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;CACJ;AArBD,oDAqBC"}

package/dist/workflow/implement/resource-check/tools/doc-semantic/builder.d.ts

@@ -0,0 +1,15 @@
+import { MarkdownParser, type MarkdownNode } from "../../../../../tools/ast-parser/markdown";
+import { LinePattern } from "../../../../../tools/line-pattern";
+import type { ArgumentList, AttributeList, BuildDiagnostic, DocBlockView, ExampleList, FrontMatter, Import, TimeOut, Title } from "./types";
+import { DocSemanticView } from "./types";
+export declare const ARG_BULLET_PATTERN: LinePattern;
+export declare const ATTR_BULLET_PATTERN: LinePattern;
+export declare function buildDocSemanticView(ast: MarkdownNode, source: string, parser?: MarkdownParser): DocSemanticView;
+export declare function buildFrontMatter(parser: MarkdownParser, ast: MarkdownNode, diagnostics: BuildDiagnostic[]): DocBlockView<FrontMatter> | null;
+export declare function buildTitle(parser: MarkdownParser, ast: MarkdownNode, diagnostics: BuildDiagnostic[]): DocBlockView<Title> | null;
+export declare function buildExampleList(parser: MarkdownParser, ast: MarkdownNode, diagnostics: BuildDiagnostic[]): DocBlockView<ExampleList> | null;
+export declare function buildArgumentList(parser: MarkdownParser, ast: MarkdownNode, source: string, diagnostics: BuildDiagnostic[]): DocBlockView<ArgumentList> | null;
+export declare function buildAttributeList(parser: MarkdownParser, ast: MarkdownNode, source: string, diagnostics: BuildDiagnostic[]): DocBlockView<AttributeList> | null;
+export declare function buildImport(parser: MarkdownParser, ast: MarkdownNode, diagnostics: BuildDiagnostic[]): DocBlockView<Import>;
+export declare function buildTimeOut(parser: MarkdownParser, ast: MarkdownNode, source: string, diagnostics: BuildDiagnostic[]): DocBlockView<TimeOut> | null;
+//# sourceMappingURL=builder.d.ts.map

package/dist/workflow/implement/resource-check/tools/doc-semantic/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../../src/workflow/implement/resource-check/tools/doc-semantic/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,YAAY,EAEpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACH,WAAW,EAMd,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAER,YAAY,EAEZ,aAAa,EACb,eAAe,EAGf,YAAY,EAEZ,WAAW,EACX,WAAW,EACX,MAAM,EAEN,OAAO,EACP,KAAK,EACR,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM1C,eAAO,MAAM,kBAAkB,aAa7B,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAO9B,CAAC;AAEH,wBAAgB,oBAAoB,CAChC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,cAAqC,GAC9C,eAAe,CAyBjB;AAED,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,eAAe,EAAE,GAC/B,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI,CAuBlC;AAED,wBAAgB,UAAU,CACtB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,eAAe,EAAE,GAC/B,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,CAoC5B;AAED,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,eAAe,EAAE,GAC/B,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI,CA0ClC;AAED,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,EAAE,GAC/B,YAAY,CAAC,YAAY,CAAC,GAAG,IAAI,CAwCnC;AAED,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,EAAE,GAC/B,YAAY,CAAC,aAAa,CAAC,GAAG,IAAI,CA0CpC;AAED,wBAAgB,WAAW,CACvB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,eAAe,EAAE,GAC/B,YAAY,CAAC,MAAM,CAAC,CAgCtB;AAED,wBAAgB,YAAY,CACxB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,EAAE,GAC/B,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAgC9B"}