@carlonicora/nestjs-neo4jsonapi 1.76.0 → 1.77.0

package/dist/foundations/help-content-sync/services/help-content-sync.service.js

@@ -0,0 +1,111 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var HelpContentSyncService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelpContentSyncService = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const how_to_repository_1 = require("../../how-to/repositories/how-to.repository");
+const how_to_service_1 = require("../../how-to/services/how-to.service");
+const redis_lock_service_1 = require("../../../core/redis/services/redis.lock.service");
+const mdx_to_markdown_service_1 = require("./mdx-to-markdown.service");
+const tokens_1 = require("../tokens");
+const to_content_id_1 = require("../helpers/to-content-id");
+const LOCK_KEY = "nestjs-neo4jsonapi:help-content-sync:lock";
+const LOCK_TTL_SECONDS = 300;
+let HelpContentSyncService = HelpContentSyncService_1 = class HelpContentSyncService {
+    constructor(config, howToRepository, howToService, mdxToMarkdown, lock, clsService) {
+        this.config = config;
+        this.howToRepository = howToRepository;
+        this.howToService = howToService;
+        this.mdxToMarkdown = mdxToMarkdown;
+        this.lock = lock;
+        this.clsService = clsService;
+        this.logger = new common_1.Logger(HelpContentSyncService_1.name);
+    }
+    onApplicationBootstrap() {
+        void this.run().catch((err) => this.logger.error(`Help content sync failed: ${err.message}`, err.stack));
+    }
+    async run() {
+        await this.lock.withLock(LOCK_KEY, LOCK_TTL_SECONDS, async () => {
+            await this.clsService.run(async () => {
+                await this.runInsideCls();
+            });
+        });
+    }
+    async runInsideCls() {
+        const articles = this.config.manifest.filter((a) => a.aiIndexed && !a.draft);
+        let created = 0, updated = 0, skipped = 0, redirected = 0, deleted = 0;
+        for (const article of articles) {
+            const id = (0, to_content_id_1.toContentId)(article.mode, article.slug, this.config.namespaceUuid);
+            const existing = await this.howToService.findRecordById({ id });
+            const plainMarkdown = await this.mdxToMarkdown.convert(await this.config.readRawMarkdown(article));
+            const baseFields = {
+                id,
+                name: article.title,
+                description: article.summary,
+                pages: plainMarkdown,
+                helpContentSlug: `${article.mode}/${article.slug}`,
+                contentHash: article.contentHash,
+            };
+            if (!existing) {
+                await this.howToRepository.create(baseFields);
+                await this.howToService.queueHowToForProcessingFromMarkdown({
+                    howToId: id,
+                    markdown: plainMarkdown,
+                });
+                created++;
+            }
+            else if (existing.contentHash !== article.contentHash) {
+                await this.howToRepository.patch(baseFields);
+                await this.howToService.queueHowToForProcessingFromMarkdown({
+                    howToId: id,
+                    markdown: plainMarkdown,
+                });
+                updated++;
+            }
+            else {
+                skipped++;
+            }
+        }
+        const manifestSlugs = new Set(articles.map((a) => `${a.mode}/${a.slug}`));
+        const managed = await this.howToRepository.findAllWithHelpContentSlug();
+        const redirects = this.config.redirects ?? [];
+        for (const orphan of managed) {
+            if (!orphan.helpContentSlug || manifestSlugs.has(orphan.helpContentSlug))
+                continue;
+            const moved = redirects.find((r) => r.from === orphan.helpContentSlug);
+            if (moved) {
+                await this.howToRepository.patch({ id: orphan.id, helpContentSlug: moved.to });
+                redirected++;
+            }
+            else {
+                await this.howToRepository.delete({ id: orphan.id });
+                deleted++;
+            }
+        }
+        this.logger.log(`Help content sync done — created=${created} updated=${updated} skipped=${skipped} redirected=${redirected} deleted=${deleted}`);
+    }
+};
+exports.HelpContentSyncService = HelpContentSyncService;
+exports.HelpContentSyncService = HelpContentSyncService = HelpContentSyncService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(tokens_1.HELP_CONTENT_CONFIG_TOKEN)),
+    __metadata("design:paramtypes", [Object, how_to_repository_1.HowToRepository,
+        how_to_service_1.HowToService,
+        mdx_to_markdown_service_1.MdxToMarkdownService,
+        redis_lock_service_1.RedisLockService,
+        nestjs_cls_1.ClsService])
+], HelpContentSyncService);
+//# sourceMappingURL=help-content-sync.service.js.map

package/dist/foundations/help-content-sync/services/help-content-sync.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-content-sync.service.js","sourceRoot":"","sources":["../../../../src/foundations/help-content-sync/services/help-content-sync.service.ts"],"names":[],"mappings":"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"}

package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.d.ts

@@ -0,0 +1,13 @@
+export declare class MdxToMarkdownService {
+    /**
+     * Convert MDX source into plain markdown suitable for the chunker.
+     * Known JSX components are rewritten to text-equivalent markdown;
+     * unknown JSX is dropped silently.
+     */
+    convert(mdx: string): Promise<string>;
+    private transformTree;
+    private transformNode;
+    private transformJsx;
+    private flattenText;
+}
+//# sourceMappingURL=mdx-to-markdown.service.d.ts.map

package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-to-markdown.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/help-content-sync/services/mdx-to-markdown.service.ts"],"names":[],"mappings":"AAUA,qBACa,oBAAoB;IAC/B;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.js

@@ -0,0 +1,104 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MdxToMarkdownService = void 0;
+const common_1 = require("@nestjs/common");
+const unified_1 = require("unified");
+const remark_parse_1 = __importDefault(require("remark-parse"));
+const remark_mdx_1 = __importDefault(require("remark-mdx"));
+const mdast_util_to_markdown_1 = require("mdast-util-to-markdown");
+const mdast_util_mdx_1 = require("mdast-util-mdx");
+let MdxToMarkdownService = class MdxToMarkdownService {
+    /**
+     * Convert MDX source into plain markdown suitable for the chunker.
+     * Known JSX components are rewritten to text-equivalent markdown;
+     * unknown JSX is dropped silently.
+     */
+    async convert(mdx) {
+        const tree = (0, unified_1.unified)().use(remark_parse_1.default).use(remark_mdx_1.default).parse(mdx);
+        const transformed = this.transformTree(tree);
+        return (0, mdast_util_to_markdown_1.toMarkdown)(transformed, { extensions: [(0, mdast_util_mdx_1.mdxToMarkdown)()] });
+    }
+    transformTree(tree) {
+        tree.children = tree.children.flatMap((child) => this.transformNode(child));
+        return tree;
+    }
+    transformNode(node) {
+        if (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") {
+            return this.transformJsx(node);
+        }
+        if ("children" in node && Array.isArray(node.children)) {
+            node.children = node.children.flatMap((c) => this.transformNode(c));
+        }
+        return [node];
+    }
+    transformJsx(node) {
+        switch (node.name) {
+            case "Callout": {
+                const typeAttr = (node.attributes ?? []).find((a) => a.name === "type");
+                const type = typeAttr?.value ?? "info";
+                const prefix = `${String(type).charAt(0).toUpperCase() + String(type).slice(1)}: `;
+                const innerText = this.flattenText(node);
+                return [
+                    {
+                        type: "blockquote",
+                        children: [{ type: "paragraph", children: [{ type: "text", value: prefix + innerText }] }],
+                    },
+                ];
+            }
+            case "Steps": {
+                const steps = (node.children ?? []).filter((c) => (c.type === "mdxJsxFlowElement" || c.type === "mdxJsxTextElement") && c.name === "Step");
+                return [
+                    {
+                        type: "list",
+                        ordered: true,
+                        start: 1,
+                        spread: false,
+                        children: steps.map((s) => ({
+                            type: "listItem",
+                            spread: false,
+                            children: [{ type: "paragraph", children: [{ type: "text", value: this.flattenText(s) }] }],
+                        })),
+                    },
+                ];
+            }
+            case "Screenshot": {
+                const caption = (node.attributes ?? []).find((a) => a.name === "caption")?.value ?? "image";
+                return [{ type: "paragraph", children: [{ type: "text", value: `[Screenshot: ${caption}]` }] }];
+            }
+            case "Video": {
+                const src = (node.attributes ?? []).find((a) => a.name === "src")?.value ?? "";
+                return [{ type: "paragraph", children: [{ type: "text", value: `[Video: ${src}]` }] }];
+            }
+            case "EntityRef":
+            case "KeyBinding": {
+                return [{ type: "text", value: this.flattenText(node) }];
+            }
+            case "Related":
+            default:
+                return [];
+        }
+    }
+    flattenText(node) {
+        if (!node)
+            return "";
+        if (typeof node.value === "string")
+            return node.value;
+        if (Array.isArray(node.children))
+            return node.children.map((c) => this.flattenText(c)).join("");
+        return "";
+    }
+};
+exports.MdxToMarkdownService = MdxToMarkdownService;
+exports.MdxToMarkdownService = MdxToMarkdownService = __decorate([
+    (0, common_1.Injectable)()
+], MdxToMarkdownService);
+//# sourceMappingURL=mdx-to-markdown.service.js.map

package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-to-markdown.service.js","sourceRoot":"","sources":["../../../../src/foundations/help-content-sync/services/mdx-to-markdown.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,qCAAkC;AAClC,gEAAuC;AACvC,4DAAmC;AACnC,mEAAoD;AACpD,mDAAmE;AAM5D,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,GAAW;QACvB,MAAM,IAAI,GAAG,IAAA,iBAAO,GAAE,CAAC,GAAG,CAAC,sBAAW,CAAC,CAAC,GAAG,CAAC,oBAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAS,CAAC;QAC1E,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,IAAA,mCAAU,EAAC,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,IAAA,8BAAgB,GAAE,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAEO,aAAa,CAAC,IAAU;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAkB,CAAC;QAC7F,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,aAAa,CAAC,IAAa;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YAC3E,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,UAAU,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAEO,YAAY,CAAC,IAAa;QAChC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBAC7E,MAAM,IAAI,GAAG,QAAQ,EAAE,KAAK,IAAI,MAAM,CAAC;gBACvC,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnF,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACzC,OAAO;oBACL;wBACE,IAAI,EAAE,YAAY;wBAClB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,CAAC;qBAC3E;iBAClB,CAAC;YACJ,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CACxC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CACpG,CAAC;gBACF,OAAO;oBACL;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,IAAI;wBACb,KAAK,EAAE,CAAC;wBACR,MAAM,EAAE,KAAK;wBACb,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;4BAC/B,IAAI,EAAE,UAAU;4BAChB,MAAM,EAAE,KAAK;4BACb,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;yBAC5F,CAAC,CAAC;qBACY;iBAClB,CAAC;YACJ,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,KAAK,IAAI,OAAO,CAAC;gBACjG,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAClG,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;gBACpF,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACzF,CAAC;YACD,KAAK,WAAW,CAAC;YACjB,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAiB,CAAC,CAAC;YAC1E,CAAC;YACD,KAAK,SAAS,CAAC;YACf;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,IAAa;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QACtD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAA;AAnFY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;GACA,oBAAoB,CAmFhC"}

package/dist/foundations/help-content-sync/tokens.d.ts

@@ -0,0 +1,2 @@
+export declare const HELP_CONTENT_CONFIG_TOKEN: unique symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/foundations/help-content-sync/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/foundations/help-content-sync/tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,eAAsC,CAAC"}

package/dist/foundations/help-content-sync/tokens.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP_CONTENT_CONFIG_TOKEN = void 0;
+exports.HELP_CONTENT_CONFIG_TOKEN = Symbol("HELP_CONTENT_CONFIG_TOKEN");
+//# sourceMappingURL=tokens.js.map

package/dist/foundations/help-content-sync/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/foundations/help-content-sync/tokens.ts"],"names":[],"mappings":";;;AAAa,QAAA,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC"}

package/dist/foundations/how-to/entities/how-to.d.ts

@@ -9,6 +9,8 @@ export type HowTo = Entity & {
     abstract?: string;
     tldr?: string;
     aiStatus?: string;
+    helpContentSlug?: string;
+    contentHash?: string;
     relevance?: number;
 };
 /**

package/dist/foundations/how-to/entities/how-to.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/entities/how-to.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,uDA0B1B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC"}
+{"version":3,"file":"how-to.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/entities/how-to.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,uDA4B1B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC"}

package/dist/foundations/how-to/entities/how-to.js

@@ -19,6 +19,8 @@ exports.HowToDescriptor = (0, common_1.defineEntity)()({
         abstract: { type: "string" },
         tldr: { type: "string" },
         aiStatus: { type: "string" },
+        helpContentSlug: { type: "string" },
+        contentHash: { type: "string" },
     },
     computed: {
         relevance: {

package/dist/foundations/how-to/entities/how-to.js.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/entities/how-to.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,+CAA0C;AAgB1C;;;;;GAKG;AACU,QAAA,eAAe,GAAG,IAAA,qBAAY,GAAS,CAAC;IACnD,GAAG,uBAAS;IAEZ,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC7B;IAED,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;gBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACzC,IAAI,KAAK,EAAE,QAAQ;oBAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;YACpC,CAAC;SACF;KACF;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}
+{"version":3,"file":"how-to.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/entities/how-to.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,+CAA0C;AAkB1C;;;;;GAKG;AACU,QAAA,eAAe,GAAG,IAAA,qBAAY,GAAS,CAAC;IACnD,GAAG,uBAAS;IAEZ,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACnC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAChC;IAED,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;gBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACzC,IAAI,KAAK,EAAE,QAAQ;oBAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;YACpC,CAAC;SACF;KACF;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/how-to/repositories/how-to.repository.d.ts

@@ -14,5 +14,11 @@ export declare class HowToRepository extends AbstractRepository<HowTo, typeof Ho
         id: string;
         aiStatus: AiStatus;
     }): Promise<void>;
+    /**
+     * Returns every HowTo node whose helpContentSlug is set.
+     * Used by the help-content sync's deletion sweep to detect orphans.
+     * Unpaginated by design — this is a maintenance pass, not a JSON:API endpoint.
+     */
+    findAllWithHelpContentSlug(): Promise<HowTo[]>;
 }
 //# sourceMappingURL=how-to.repository.d.ts.map

package/dist/foundations/how-to/repositories/how-to.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/repositories/how-to.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG5D,qBACa,eAAgB,SAAQ,kBAAkB,CAAC,KAAK,EAAE,OAAO,eAAe,CAAC,aAAa,CAAC;IAClG,SAAS,CAAC,QAAQ,CAAC,UAAU,iDAAmB;gBAEpC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB9E"}
+{"version":3,"file":"how-to.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/repositories/how-to.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG5D,qBACa,eAAgB,SAAQ,kBAAkB,CAAC,KAAK,EAAE,OAAO,eAAe,CAAC,aAAa,CAAC;IAClG,SAAS,CAAC,QAAQ,CAAC,UAAU,iDAAmB;gBAEpC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7E;;;;OAIG;IACG,0BAA0B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CASrD"}

package/dist/foundations/how-to/repositories/how-to.repository.js

@@ -38,6 +38,20 @@ let HowToRepository = class HowToRepository extends abstract_repository_1.Abstra
     `;
         await this.neo4j.writeOne(query);
     }
+    /**
+     * Returns every HowTo node whose helpContentSlug is set.
+     * Used by the help-content sync's deletion sweep to detect orphans.
+     * Unpaginated by design — this is a maintenance pass, not a JSON:API endpoint.
+     */
+    async findAllWithHelpContentSlug() {
+        const query = this.neo4j.initQuery({ serialiser: how_to_1.HowToDescriptor.model });
+        query.query = `
+      ${this.buildDefaultMatch()}
+      WHERE ${how_to_meta_1.howToMeta.nodeName}.helpContentSlug IS NOT NULL
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readMany(query);
+    }
 };
 exports.HowToRepository = HowToRepository;
 exports.HowToRepository = HowToRepository = __decorate([

package/dist/foundations/how-to/repositories/how-to.repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.repository.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/repositories/how-to.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AAExC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,+CAA4D;AAC5D,yDAAoD;AAG7C,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,wCAA+D;IAGlG,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,wBAAe,CAAC;IAIhD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0C;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAErC,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG;eACH,uBAAS,CAAC,QAAQ,IAAI,uBAAS,CAAC,SAAS;YAC5C,uBAAS,CAAC,QAAQ,0BAA0B,uBAAS,CAAC,QAAQ;KACrE,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AA1BY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;qCAIQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAH9E,eAAe,CA0B3B"}
+{"version":3,"file":"how-to.repository.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/repositories/how-to.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AAExC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,+CAA4D;AAC5D,yDAAoD;AAG7C,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,wCAA+D;IAGlG,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,wBAAe,CAAC;IAIhD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0C;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAErC,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG;eACH,uBAAS,CAAC,QAAQ,IAAI,uBAAS,CAAC,SAAS;YAC5C,uBAAS,CAAC,QAAQ,0BAA0B,uBAAS,CAAC,QAAQ;KACrE,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,0BAA0B;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,wBAAe,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1E,KAAK,CAAC,KAAK,GAAG;QACV,IAAI,CAAC,iBAAiB,EAAE;cAClB,uBAAS,CAAC,QAAQ;QACxB,IAAI,CAAC,oBAAoB,EAAE;KAC9B,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AAzCY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;qCAIQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAH9E,eAAe,CAyC3B"}

package/dist/foundations/how-to/services/how-to.service.d.ts

@@ -25,12 +25,24 @@ export declare class HowToService extends AbstractService<HowTo, typeof HowToDes
     constructor(jsonApiService: JsonApiService, howToRepository: HowToRepository, clsService: ClsService, chunkService: ChunkService, chunkerService: ChunkerService, blockNoteService: BlockNoteService, webSocketService: WebSocketService, chunkRepository: ChunkRepository, chunkQueue: Queue, configService: ConfigService<BaseConfigInterface>);
     /**
      * Queue a HowTo for AI processing.
-     * Converts BlockNote JSON to Markdown, chunks it, and queues each chunk.
+     * Converts BlockNote JSON to Markdown, then delegates to _chunkAndQueue.
      */
     queueHowToForProcessing(params: {
         howToId: string;
         description: string;
     }): Promise<void>;
+    /**
+     * Queue a HowTo for AI processing from pre-rendered markdown.
+     * Used by the help-content sync — bypasses the BlockNote conversion.
+     */
+    queueHowToForProcessingFromMarkdown(params: {
+        howToId: string;
+        markdown: string;
+    }): Promise<void>;
+    /**
+     * Private: mark in-progress, delete prior chunks, chunk the markdown, enqueue jobs.
+     */
+    private _chunkAndQueue;
     /**
      * Update AI status and broadcast progress via WebSocket.
      */

package/dist/foundations/how-to/services/how-to.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/services/how-to.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAGvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,qBACa,YAAa,SAAQ,eAAe,CAAC,KAAK,EAAE,OAAO,eAAe,CAAC,aAAa,CAAC;IAM1F,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IACJ,OAAO,CAAC,QAAQ,CAAC,UAAU;IAZzD,SAAS,CAAC,QAAQ,CAAC,UAAU,iDAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;gBAGjD,cAAc,EAAE,cAAc,EACb,eAAe,EAAE,eAAe,EACjD,UAAU,EAAE,UAAU,EACL,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,gBAAgB,EAClC,eAAe,EAAE,eAAe,EACJ,UAAU,EAAE,KAAK,EAC9D,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAMnD;;;OAGG;IACG,uBAAuB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC9F;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BhF"}
+{"version":3,"file":"how-to.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/services/how-to.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAGvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,qBACa,YAAa,SAAQ,eAAe,CAAC,KAAK,EAAE,OAAO,eAAe,CAAC,aAAa,CAAC;IAM1F,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IACJ,OAAO,CAAC,QAAQ,CAAC,UAAU;IAZzD,SAAS,CAAC,QAAQ,CAAC,UAAU,iDAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;gBAGjD,cAAc,EAAE,cAAc,EACb,eAAe,EAAE,eAAe,EACjD,UAAU,EAAE,UAAU,EACL,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,gBAAgB,EAClC,eAAe,EAAE,eAAe,EACJ,UAAU,EAAE,KAAK,EAC9D,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAMnD;;;OAGG;IACG,uBAAuB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9F;;;OAGG;IACG,mCAAmC,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvG;;OAEG;YACW,cAAc;IAuC5B;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BhF"}

package/dist/foundations/how-to/services/how-to.service.js

@@ -45,9 +45,23 @@ let HowToService = class HowToService extends abstract_service_1.AbstractService
     }
     /**
      * Queue a HowTo for AI processing.
-     * Converts BlockNote JSON to Markdown, chunks it, and queues each chunk.
+     * Converts BlockNote JSON to Markdown, then delegates to _chunkAndQueue.
      */
     async queueHowToForProcessing(params) {
+        const markdown = this.blockNoteService.convertToMarkdown({ nodes: JSON.parse(params.description) });
+        await this._chunkAndQueue({ howToId: params.howToId, markdown });
+    }
+    /**
+     * Queue a HowTo for AI processing from pre-rendered markdown.
+     * Used by the help-content sync — bypasses the BlockNote conversion.
+     */
+    async queueHowToForProcessingFromMarkdown(params) {
+        await this._chunkAndQueue(params);
+    }
+    /**
+     * Private: mark in-progress, delete prior chunks, chunk the markdown, enqueue jobs.
+     */
+    async _chunkAndQueue(params) {
         await this.updateAiStatus({
             id: params.howToId,
             aiStatus: ai_status_1.AiStatus.InProgress,
@@ -57,7 +71,7 @@ let HowToService = class HowToService extends abstract_service_1.AbstractService
             nodeType: how_to_meta_1.howToMeta.labelName,
         });
         const data = await this.chunkerService.generateContentStructureFromMarkdown({
-            content: this.blockNoteService.convertToMarkdown({ nodes: JSON.parse(params.description) }),
+            content: params.markdown,
         });
         const chunks = await this.chunkService.createChunks({
             id: params.howToId,

package/dist/foundations/how-to/services/how-to.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.service.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/services/how-to.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"how-to.service.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/services/how-to.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA6C;AAC7C,2CAA4C;AAC5C,2CAA+C;AAC/C,mCAA+B;AAC/B,2CAAwC;AACxC,+DAA2D;AAG3D,6DAAyD;AACzD,0FAAsF;AACtF,oFAAgF;AAChF,qFAAiF;AACjF,0FAAsF;AAEtF,gFAA4E;AAC5E,sEAAkE;AAClE,4EAAwE;AACxE,+CAA4D;AAC5D,yDAAoD;AACpD,yEAAoE;AAG7D,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,kCAA4D;IAI5F,YACE,cAA8B,EACb,eAAgC,EACjD,UAAsB,EACL,YAA0B,EAC1B,cAA8B,EAC9B,gBAAkC,EAClC,gBAAkC,EAClC,eAAgC,EACrB,UAAkC,EAC9D,aAAiD;QAEjD,KAAK,CAAC,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,wBAAe,CAAC,KAAK,CAAC,CAAC;QAVzD,oBAAe,GAAf,eAAe,CAAiB;QAEhC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,mBAAc,GAAd,cAAc,CAAgB;QAC9B,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,oBAAe,GAAf,eAAe,CAAiB;QACJ,eAAU,GAAV,UAAU,CAAO;QAZ7C,eAAU,GAAG,wBAAe,CAAC;QAgB9C,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IACvG,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,uBAAuB,CAAC,MAAgD;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACpG,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mCAAmC,CAAC,MAA6C;QACrF,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,MAA6C;QACxE,MAAM,IAAI,CAAC,cAAc,CAAC;YACxB,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,QAAQ,EAAE,oBAAQ,CAAC,UAAU;SAC9B,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;YACnC,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,QAAQ,EAAE,uBAAS,CAAC,SAAS;SAC9B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,oCAAoC,CAAC;YAC1E,OAAO,EAAE,MAAM,CAAC,QAAQ;SACzB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAY,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;YAC3D,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,QAAQ,EAAE,uBAAS,CAAC,SAAS;YAC7B,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,cAAc,CAAC;YACxB,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,QAAQ,EAAE,oBAAQ,CAAC,UAAU;SAC9B,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,IAAI,eAAe,CAAC;QAErE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,EAAE;gBACtC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS;gBACxD,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACrC,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,SAAS,EAAE,MAAM,CAAC,OAAO;gBACzB,WAAW,EAAE,uBAAS,CAAC,SAAS;aACjC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,MAA0C;QAC7D,MAAM,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC;YACtC,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,oBAAQ,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAY,MAAM,IAAI,CAAC,eAAe,CAAC,2BAA2B,CAAC;gBAC7E,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,uBAAS,CAAC,SAAS;aAC1B,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,gBAAgB,EAAE;gBAC7F,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAY,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,oBAAQ,CAAC,SAAS,CAAC,CAAC,MAAM;gBACxF,KAAK,EAAE,MAAM,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,gBAAgB,EAAE;gBAC7F,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,CAAC;gBACZ,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAA;AA7GY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,mBAAU,GAAE;IAcR,WAAA,IAAA,oBAAW,EAAC,kBAAO,CAAC,KAAK,CAAC,CAAA;qCARX,gCAAc;QACI,mCAAe;QACrC,uBAAU;QACS,4BAAY;QACV,gCAAc;QACZ,oCAAgB;QAChB,oCAAgB;QACjB,kCAAe;QACQ,cAAK;QAC/C,sBAAa;GAdnB,YAAY,CA6GxB"}

package/dist/foundations/index.d.ts

@@ -29,4 +29,5 @@ export * from "./tokenusage";
 export * from "./two-factor";
 export * from "./user";
 export * from "./rbac";
+export * from "./help-content-sync";
 //# sourceMappingURL=index.d.ts.map

package/dist/foundations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,uBAAuB,CAAC;AAGtC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,uBAAuB,CAAC;AAGtC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,qBAAqB,CAAC"}

package/dist/foundations/index.js

@@ -47,4 +47,5 @@ __exportStar(require("./tokenusage"), exports);
 __exportStar(require("./two-factor"), exports);
 __exportStar(require("./user"), exports);
 __exportStar(require("./rbac"), exports);
+__exportStar(require("./help-content-sync"), exports);
 //# sourceMappingURL=index.js.map

package/dist/foundations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,sFAAsF;AACtF,wDAAsC;AAEtC,iFAAiF;AACjF,8CAA4B;AAC5B,sDAAoC;AACpC,+CAA6B;AAC7B,0CAAwB;AACxB,yCAAuB;AACvB,0CAAwB;AACxB,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,iDAA+B;AAC/B,4CAA0B;AAC1B,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,yCAAuB;AACvB,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,uCAAqB;AACrB,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,sFAAsF;AACtF,wDAAsC;AAEtC,iFAAiF;AACjF,8CAA4B;AAC5B,sDAAoC;AACpC,+CAA6B;AAC7B,0CAAwB;AACxB,yCAAuB;AACvB,0CAAwB;AACxB,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,iDAA+B;AAC/B,4CAA0B;AAC1B,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,yCAAuB;AACvB,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,uCAAqB;AACrB,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB;AACvB,sDAAoC"}

package/dist/foundations/keyconcept/repositories/keyconcept.repository.d.ts

@@ -17,10 +17,24 @@ export declare class KeyConceptRepository implements OnModuleInit {
         keyConcepts: string[];
         dataLimits: DataLimits;
     }): Promise<KeyConcept[]>;
+    /**
+     * Help-content retrieval. Intentionally bypasses company filtering — `(data:HowTo)`
+     * nodes are global and have no `BELONGS_TO Company` edge. Only callable from inside
+     * this repository; `findNeighboursByKeyConcepts` dispatches here based on
+     * `dataLimits.howToMode` / `dataLimits.limitToHowToId`.
+     */
+    private findNeighboursByKeyConceptsFromHowTos;
     findPotentialKeyConcepts(params: {
         question: string;
         dataLimits: DataLimits;
     }): Promise<KeyConcept[]>;
+    /**
+     * Help-content retrieval. Intentionally bypasses company filtering — `(data:HowTo)`
+     * nodes are global and have no `BELONGS_TO Company` edge. Only callable from inside
+     * this repository; `findPotentialKeyConcepts` dispatches here based on
+     * `dataLimits.howToMode` / `dataLimits.limitToHowToId`.
+     */
+    private findPotentialKeyConceptsFromHowTos;
     deleteDisconnectedKeyConcepts(): Promise<void>;
     findKeyConceptByValue(params: {
         keyConceptValue: string;
@@ -50,7 +64,7 @@ export declare class KeyConceptRepository implements OnModuleInit {
         atomicFactId: string;
     }): Promise<void>;
     createOrUpdateKeyConceptRelationships(params: {
-        companyId: string;
+        companyId?: string;
         chunkId: string;
         relationships: {
             keyConcept1: string;

package/dist/foundations/keyconcept/repositories/keyconcept.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyconcept.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/keyconcept/repositories/keyconcept.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAI1E,qBACa,oBAAqB,YAAW,YAAY;IAErD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAJV,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,UAAU;IAGnC,YAAY;IAuBZ,2BAA2B,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoC7G,wBAAwB,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkCrG,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB9C,qBAAqB,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAgB/E,uBAAuB,CAAC,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAgBtF,uBAAuB,CAAC,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpF;;;OAGG;IACG,4BAA4B,CAAC,MAAM,EAAE;QACzC,YAAY,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC7D,GAAG,OAAO,CAAC,IAAI,CAAC;IAeX,gBAAgB,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC1F,wBAAwB,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlG,qCAAqC,CAAC,MAAM,EAAE;QAClD,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;SACtB,EAAE,CAAC;KACL,GAAG,OAAO,CAAC,IAAI,CAAC;IA6EX,kDAAkD,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBrG"}
+{"version":3,"file":"keyconcept.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/keyconcept/repositories/keyconcept.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAI1E,qBACa,oBAAqB,YAAW,YAAY;IAErD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAJV,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,UAAU;IAGnC,YAAY;IAuBZ,2BAA2B,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA0CnH;;;;;OAKG;YACW,qCAAqC;IAuC7C,wBAAwB,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAuC3G;;;;;OAKG;YACW,kCAAkC;IAoC1C,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB9C,qBAAqB,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAgB/E,uBAAuB,CAAC,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAgBtF,uBAAuB,CAAC,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpF;;;OAGG;IACG,4BAA4B,CAAC,MAAM,EAAE;QACzC,YAAY,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC7D,GAAG,OAAO,CAAC,IAAI,CAAC;IAeX,gBAAgB,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC1F,wBAAwB,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlG,qCAAqC,CAAC,MAAM,EAAE;QAClD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;SACtB,EAAE,CAAC;KACL,GAAG,OAAO,CAAC,IAAI,CAAC;IAiGX,kDAAkD,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBrG"}