@reqord/cli 0.1.0

package/dist/services/migration-service.js

@@ -0,0 +1,114 @@
+import { readFile, readdir, rename, mkdir } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { dump as yamlDump, JSON_SCHEMA } from "js-yaml";
+import { REQORD_DIR, REQUIREMENTS_DIR, SPECIFICATIONS_DIR, CONTEXT_DIR, FEEDBACK_DIR, } from "@reqord/shared";
+import * as fs from "../repositories/file-system.js";
+import { AppError, ErrorCode } from "../utils/errors.js";
+export async function createMigrationPlan(cwd) {
+    const plan = [];
+    const reqordPath = join(cwd, REQORD_DIR);
+    // Requirements
+    const requirementsPath = join(reqordPath, REQUIREMENTS_DIR);
+    if (await fs.exists(requirementsPath)) {
+        const entries = await readdir(requirementsPath);
+        for (const file of entries.filter((f) => f.endsWith(".json") && f.startsWith("req-"))) {
+            plan.push({
+                source: join(requirementsPath, file),
+                destination: join(requirementsPath, file.replace(".json", ".yaml")),
+                type: "requirement",
+            });
+        }
+    }
+    // Specifications
+    const specificationsPath = join(reqordPath, SPECIFICATIONS_DIR);
+    if (await fs.exists(specificationsPath)) {
+        const entries = await readdir(specificationsPath);
+        for (const file of entries.filter((f) => f.endsWith(".json") && f.startsWith("spec-"))) {
+            plan.push({
+                source: join(specificationsPath, file),
+                destination: join(specificationsPath, file.replace(".json", ".yaml")),
+                type: "specification",
+            });
+        }
+    }
+    // Context files
+    const contextPath = join(reqordPath, CONTEXT_DIR);
+    const contextFiles = ["product.json", "technical.json", "structure.json", "context.json"];
+    for (const file of contextFiles) {
+        const filePath = join(contextPath, file);
+        if (await fs.exists(filePath)) {
+            plan.push({
+                source: filePath,
+                destination: filePath.replace(".json", ".yaml"),
+                type: "context",
+            });
+        }
+    }
+    // Feedback (legacy format migration only)
+    // This handles JSON→YAML format conversion for the old `.reqord/feedback/index.json` path.
+    // Note: The storage path was later migrated to `.reqord/issues/feedbacks.yaml` (spec-000027),
+    // but this migration-service is only responsible for format migration (JSON→YAML) of
+    // pre-existing data at the original path. Path migration is out of scope here.
+    const feedbackIndexPath = join(reqordPath, FEEDBACK_DIR, "index.json");
+    if (await fs.exists(feedbackIndexPath)) {
+        plan.push({
+            source: feedbackIndexPath,
+            destination: feedbackIndexPath.replace(".json", ".yaml"),
+            type: "feedback",
+        });
+    }
+    return plan;
+}
+function convertToYaml(data) {
+    return yamlDump(data, {
+        indent: 2,
+        lineWidth: 120,
+        noRefs: true,
+        sortKeys: false,
+        schema: JSON_SCHEMA,
+    });
+}
+export async function migrateToYaml(cwd, options) {
+    const reqordPath = join(cwd, REQORD_DIR);
+    if (!(await fs.exists(reqordPath))) {
+        throw new AppError(".reqord/ directory not found. Run 'reqord init' first.", ErrorCode.NOT_FOUND);
+    }
+    const plan = await createMigrationPlan(cwd);
+    if (options.dryRun) {
+        return { plan, success: [], errors: [] };
+    }
+    // Create backup directory with timestamp to allow multiple runs per day
+    const now = new Date();
+    const datePart = now.toISOString().split("T")[0];
+    const timePart = now.toTimeString().split(" ")[0].replace(/:/g, "-");
+    const backupDir = join(reqordPath, ".backup", `${datePart}_${timePart}`);
+    await mkdir(backupDir, { recursive: true });
+    const success = [];
+    const errors = [];
+    for (const item of plan) {
+        try {
+            const jsonContent = await readFile(item.source, "utf-8");
+            const data = JSON.parse(jsonContent);
+            const yamlContent = convertToYaml(data);
+            await fs.writeText(item.destination, yamlContent);
+            // Move original JSON to backup, preserving directory structure
+            const relPath = relative(reqordPath, item.source);
+            const backupPath = join(backupDir, relPath);
+            await mkdir(join(backupPath, ".."), { recursive: true });
+            await rename(item.source, backupPath);
+            success.push(item.destination);
+        }
+        catch (error) {
+            errors.push({
+                file: item.source,
+                reason: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    // Abort if too many errors
+    if (plan.length > 0 && errors.length > 0 && errors.length / plan.length > 0.1) {
+        throw new AppError(`Migration aborted: error rate exceeded 10% (${errors.length}/${plan.length} failed). Use --dry-run to check.`, ErrorCode.MIGRATION_FAILED);
+    }
+    return { plan, success, errors };
+}
+//# sourceMappingURL=migration-service.js.map

package/dist/services/migration-service.js.map

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

package/dist/services/migration-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migration-service.test.d.ts.map

package/dist/services/migration-service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-service.test.d.ts","sourceRoot":"","sources":["../../src/services/migration-service.test.ts"],"names":[],"mappings":""}

package/dist/services/migration-service.test.js

@@ -0,0 +1,269 @@
+import { mkdtemp, writeFile, readFile, mkdir, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { rm, access } from "node:fs/promises";
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { load as yamlLoad } from "js-yaml";
+import { createMigrationPlan, migrateToYaml } from "./migration-service.js";
+import { AppError } from "../utils/errors.js";
+let tmpDir;
+beforeEach(async () => {
+    tmpDir = await mkdtemp(join(tmpdir(), "reqord-migration-test-"));
+});
+afterEach(async () => {
+    await rm(tmpDir, { recursive: true, force: true });
+});
+// Helper function to set up .reqord structure
+async function setupReqordDir() {
+    const reqordDir = join(tmpDir, ".reqord");
+    const reqDir = join(reqordDir, "requirements");
+    const specDir = join(reqordDir, "specifications");
+    const contextDir = join(reqordDir, "context");
+    const feedbackDir = join(reqordDir, "feedback");
+    await mkdir(reqDir, { recursive: true });
+    await mkdir(specDir, { recursive: true });
+    await mkdir(contextDir, { recursive: true });
+    await mkdir(feedbackDir, { recursive: true });
+    return { reqordDir, reqDir, specDir, contextDir, feedbackDir };
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Minimal valid JSON test data
+const minReq = {
+    id: "req-000001",
+    title: "Test Requirement",
+    version: "1.0.0",
+    status: "draft",
+    priority: "medium",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z",
+    versionHistory: [],
+    files: {
+        description: "requirements/req-000001/description.md",
+        supplementary: [],
+    },
+    format: {
+        type: "free-form",
+    },
+    dependencies: {
+        blockedBy: [],
+        blocks: [],
+        relatedTo: [],
+    },
+};
+const minSpec = {
+    id: "spec-000001",
+    requirementId: "req-000001",
+    version: "1.0.0",
+    status: "draft",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z",
+    versionHistory: [],
+    files: {
+        description: "specifications/spec-000001/description.md",
+        supplementary: [],
+    },
+};
+const minContext = {
+    productName: "Test Product",
+    description: "Test Description",
+    domain: "Test Domain",
+};
+const minFeedback = {
+    items: [],
+    metadata: {
+        totalCount: 0,
+        lastUpdated: "2026-01-01T00:00:00.000Z",
+    },
+};
+describe("migration-service", () => {
+    describe("createMigrationPlan", () => {
+        it("detects requirement JSON files in .reqord/requirements/", async () => {
+            const { reqDir } = await setupReqordDir();
+            await writeFile(join(reqDir, "req-000001.json"), JSON.stringify(minReq, null, 2));
+            await writeFile(join(reqDir, "req-000002.json"), JSON.stringify(minReq, null, 2));
+            const plan = await createMigrationPlan(tmpDir);
+            expect(plan).toHaveLength(2);
+            expect(plan[0].type).toBe("requirement");
+            expect(plan[0].source).toContain("req-000001.json");
+            expect(plan[0].destination).toContain("req-000001.yaml");
+            expect(plan[1].source).toContain("req-000002.json");
+        });
+        it("detects specification JSON files in .reqord/specifications/", async () => {
+            const { specDir } = await setupReqordDir();
+            await writeFile(join(specDir, "spec-000001.json"), JSON.stringify(minSpec, null, 2));
+            await writeFile(join(specDir, "spec-000002.json"), JSON.stringify(minSpec, null, 2));
+            const plan = await createMigrationPlan(tmpDir);
+            expect(plan).toHaveLength(2);
+            expect(plan[0].type).toBe("specification");
+            expect(plan[0].source).toContain("spec-000001.json");
+            expect(plan[0].destination).toContain("spec-000001.yaml");
+            expect(plan[1].source).toContain("spec-000002.json");
+        });
+        it("detects context JSON files (product.json, technical.json, structure.json, context.json)", async () => {
+            const { contextDir } = await setupReqordDir();
+            await writeFile(join(contextDir, "product.json"), JSON.stringify(minContext, null, 2));
+            await writeFile(join(contextDir, "technical.json"), JSON.stringify(minContext, null, 2));
+            await writeFile(join(contextDir, "structure.json"), JSON.stringify(minContext, null, 2));
+            await writeFile(join(contextDir, "context.json"), JSON.stringify(minContext, null, 2));
+            const plan = await createMigrationPlan(tmpDir);
+            expect(plan).toHaveLength(4);
+            expect(plan.every((item) => item.type === "context")).toBe(true);
+            expect(plan.some((item) => item.source.endsWith("product.json"))).toBe(true);
+            expect(plan.some((item) => item.source.endsWith("technical.json"))).toBe(true);
+            expect(plan.some((item) => item.source.endsWith("structure.json"))).toBe(true);
+            expect(plan.some((item) => item.source.endsWith("context.json"))).toBe(true);
+        });
+        it("detects feedback index.json", async () => {
+            const { feedbackDir } = await setupReqordDir();
+            await writeFile(join(feedbackDir, "index.json"), JSON.stringify(minFeedback, null, 2));
+            const plan = await createMigrationPlan(tmpDir);
+            expect(plan).toHaveLength(1);
+            expect(plan[0].type).toBe("feedback");
+            expect(plan[0].source).toContain("index.json");
+            expect(plan[0].destination).toContain("index.yaml");
+        });
+        it("returns empty plan for empty .reqord directory", async () => {
+            await setupReqordDir();
+            const plan = await createMigrationPlan(tmpDir);
+            expect(plan).toHaveLength(0);
+        });
+        it("does NOT include .md files or non-JSON files", async () => {
+            const { reqDir, specDir, contextDir } = await setupReqordDir();
+            await writeFile(join(reqDir, "req-000001.md"), "# Markdown file");
+            await writeFile(join(specDir, "spec-000001.txt"), "Text file");
+            await writeFile(join(contextDir, "product.yaml"), "yaml: file");
+            await writeFile(join(reqDir, "random.json"), "{}"); // Does not start with req-
+            const plan = await createMigrationPlan(tmpDir);
+            expect(plan).toHaveLength(0);
+        });
+    });
+    describe("migrateToYaml - dryRun mode", () => {
+        it("returns plan without modifying any files (dryRun: true)", async () => {
+            const { reqDir } = await setupReqordDir();
+            const reqFile = join(reqDir, "req-000001.json");
+            await writeFile(reqFile, JSON.stringify(minReq, null, 2));
+            const result = await migrateToYaml(tmpDir, { dryRun: true });
+            expect(result.plan).toHaveLength(1);
+            expect(result.success).toHaveLength(0);
+            expect(result.errors).toHaveLength(0);
+            expect(result.plan[0].source).toContain("req-000001.json");
+            expect(result.plan[0].destination).toContain("req-000001.yaml");
+        });
+        it("JSON files still exist after dry run", async () => {
+            const { reqDir } = await setupReqordDir();
+            const reqFile = join(reqDir, "req-000001.json");
+            await writeFile(reqFile, JSON.stringify(minReq, null, 2));
+            await migrateToYaml(tmpDir, { dryRun: true });
+            const content = await readFile(reqFile, "utf-8");
+            expect(JSON.parse(content)).toEqual(minReq);
+            const files = await readdir(reqDir);
+            expect(files).toContain("req-000001.json");
+            expect(files).not.toContain("req-000001.yaml");
+        });
+    });
+    describe("migrateToYaml - actual migration", () => {
+        it("converts JSON files to YAML files", async () => {
+            const { reqDir } = await setupReqordDir();
+            const reqFile = join(reqDir, "req-000001.json");
+            await writeFile(reqFile, JSON.stringify(minReq, null, 2));
+            const result = await migrateToYaml(tmpDir, { dryRun: false });
+            expect(result.success).toHaveLength(1);
+            expect(result.errors).toHaveLength(0);
+            const yamlFile = join(reqDir, "req-000001.yaml");
+            const yamlContent = await readFile(yamlFile, "utf-8");
+            expect(yamlContent).toContain("id: req-000001");
+            expect(yamlContent).toContain("title: Test Requirement");
+        });
+        it("creates backup with directory structure preserved", async () => {
+            const { reqDir, contextDir, reqordDir } = await setupReqordDir();
+            await writeFile(join(reqDir, "req-000001.json"), JSON.stringify(minReq, null, 2));
+            await writeFile(join(contextDir, "context.json"), JSON.stringify(minContext, null, 2));
+            await migrateToYaml(tmpDir, { dryRun: false });
+            // Find the backup directory (includes timestamp)
+            const backupRoot = join(reqordDir, ".backup");
+            const backupDirs = await readdir(backupRoot);
+            expect(backupDirs).toHaveLength(1);
+            const backupDir = join(backupRoot, backupDirs[0]);
+            // Directory structure is preserved
+            const reqBackup = join(backupDir, "requirements", "req-000001.json");
+            const ctxBackup = join(backupDir, "context", "context.json");
+            expect(await fileExists(reqBackup)).toBe(true);
+            expect(await fileExists(ctxBackup)).toBe(true);
+            const backupContent = await readFile(reqBackup, "utf-8");
+            expect(JSON.parse(backupContent)).toEqual(minReq);
+        });
+        it("original JSON files are moved to backup directory", async () => {
+            const { reqDir, reqordDir } = await setupReqordDir();
+            const reqFile = join(reqDir, "req-000001.json");
+            await writeFile(reqFile, JSON.stringify(minReq, null, 2));
+            await migrateToYaml(tmpDir, { dryRun: false });
+            const files = await readdir(reqDir);
+            expect(files).not.toContain("req-000001.json");
+            expect(files).toContain("req-000001.yaml");
+            const backupRoot = join(reqordDir, ".backup");
+            const backupDirs = await readdir(backupRoot);
+            const backupDir = join(backupRoot, backupDirs[0]);
+            const backupFile = join(backupDir, "requirements", "req-000001.json");
+            expect(await fileExists(backupFile)).toBe(true);
+        });
+        it("YAML files can be parsed back to the same data", async () => {
+            const { reqDir } = await setupReqordDir();
+            const reqFile = join(reqDir, "req-000001.json");
+            await writeFile(reqFile, JSON.stringify(minReq, null, 2));
+            await migrateToYaml(tmpDir, { dryRun: false });
+            const yamlFile = join(reqDir, "req-000001.yaml");
+            const yamlContent = await readFile(yamlFile, "utf-8");
+            const parsedData = yamlLoad(yamlContent);
+            expect(parsedData.id).toBe(minReq.id);
+            expect(parsedData.title).toBe(minReq.title);
+            expect(parsedData.version).toBe(minReq.version);
+            expect(parsedData.status).toBe(minReq.status);
+            expect(parsedData.priority).toBe(minReq.priority);
+            // Default schema converts dates to Date objects, but JSON_SCHEMA in production keeps them as strings
+            expect(parsedData.files).toEqual(minReq.files);
+            expect(parsedData.format).toEqual(minReq.format);
+            expect(parsedData.dependencies).toEqual(minReq.dependencies);
+            expect(parsedData.versionHistory).toEqual(minReq.versionHistory);
+        });
+    });
+    describe("migrateToYaml - error handling", () => {
+        it("throws AppError when .reqord/ does not exist", async () => {
+            await expect(migrateToYaml(tmpDir, { dryRun: false })).rejects.toThrow(AppError);
+            await expect(migrateToYaml(tmpDir, { dryRun: false })).rejects.toThrow(".reqord/ directory not found");
+        });
+        it("throws MIGRATION_FAILED when error rate exceeds 10%", async () => {
+            const { reqDir } = await setupReqordDir();
+            // Create 5 files: 4 invalid (80% error rate) + 1 valid
+            await writeFile(join(reqDir, "req-000001.json"), "{ invalid json }");
+            await writeFile(join(reqDir, "req-000002.json"), "{ invalid json }");
+            await writeFile(join(reqDir, "req-000003.json"), "{ invalid json }");
+            await writeFile(join(reqDir, "req-000004.json"), "{ invalid json }");
+            await writeFile(join(reqDir, "req-000005.json"), JSON.stringify(minReq, null, 2));
+            await expect(migrateToYaml(tmpDir, { dryRun: false })).rejects.toThrow(AppError);
+            await expect(migrateToYaml(tmpDir, { dryRun: false })).rejects.toThrow("error rate exceeded 10%");
+        });
+        it("continues migration when error rate is at or below 10%", async () => {
+            const { reqDir } = await setupReqordDir();
+            // Create 10 files: 1 invalid (10% error rate) + 9 valid
+            await writeFile(join(reqDir, "req-000001.json"), "{ invalid json }");
+            for (let i = 2; i <= 10; i++) {
+                const id = `req-${String(i).padStart(6, "0")}`;
+                const data = { ...minReq, id };
+                await writeFile(join(reqDir, `${id}.json`), JSON.stringify(data, null, 2));
+            }
+            const result = await migrateToYaml(tmpDir, { dryRun: false });
+            expect(result.errors).toHaveLength(1);
+            expect(result.success).toHaveLength(9);
+            expect(result.errors[0].file).toContain("req-000001.json");
+        });
+    });
+});
+//# sourceMappingURL=migration-service.test.js.map

package/dist/services/migration-service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-service.test.js","sourceRoot":"","sources":["../../src/services/migration-service.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,IAAI,MAAc,CAAC;AAEnB,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,8CAA8C;AAC9C,KAAK,UAAU,cAAc;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACjE,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+BAA+B;AAC/B,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,0BAA0B;IACrC,SAAS,EAAE,0BAA0B;IACrC,cAAc,EAAE,EAAE;IAClB,KAAK,EAAE;QACL,WAAW,EAAE,wCAAwC;QACrD,aAAa,EAAE,EAAE;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;KAClB;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,EAAE;KACd;CACF,CAAC;AAEF,MAAM,OAAO,GAAG;IACd,EAAE,EAAE,aAAa;IACjB,aAAa,EAAE,YAAY;IAC3B,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,0BAA0B;IACrC,SAAS,EAAE,0BAA0B;IACrC,cAAc,EAAE,EAAE;IAClB,KAAK,EAAE;QACL,WAAW,EAAE,2CAA2C;QACxD,aAAa,EAAE,EAAE;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,GAAG;IACjB,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,kBAAkB;IAC/B,MAAM,EAAE,aAAa;CACtB,CAAC;AAEF,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE;QACR,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,0BAA0B;KACxC;CACF,CAAC;AAEF,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAClF,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAElF,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAE/C,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;YAC3E,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC3C,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACrF,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAErF,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAE/C,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yFAAyF,EAAE,KAAK,IAAI,EAAE;YACvG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC9C,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACvF,MAAM,SAAS,CACb,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAClC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CACpC,CAAC;YACF,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACzF,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvF,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAE/C,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC/C,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvF,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAE/C,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,cAAc,EAAE,CAAC;YAEvB,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAE/C,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,iBAAiB,CAAC,CAAC;YAClE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,WAAW,CAAC,CAAC;YAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,YAAY,CAAC,CAAC;YAChE,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,2BAA2B;YAE/E,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAE/C,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC3D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAE1D,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE5C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAChD,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAE9D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAChD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YACjE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YACjE,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAClF,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvF,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAE/C,iDAAiD;YACjD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAElD,mCAAmC;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;YACrE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;YAC7D,MAAM,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE/C,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YACjE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YACrD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAE1D,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAE/C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAE3C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;YACtE,MAAM,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAE1D,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAE/C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAA4B,CAAC;YAEpE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClD,qGAAqG;YACrG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7D,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;QAC9C,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACjF,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACpE,8BAA8B,CAC/B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,uDAAuD;YACvD,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,CAAC;YACrE,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,CAAC;YACrE,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,CAAC;YACrE,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,CAAC;YACrE,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAElF,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACjF,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACpE,yBAAyB,CAC1B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAC1C,wDAAwD;YACxD,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,CAAC;YACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7B,MAAM,EAAE,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC;gBAC/B,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7E,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAE9D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/services/reqord-comment.d.ts

@@ -0,0 +1,15 @@
+import type { FeedbackType, FeedbackSeverity } from "@reqord/shared";
+export interface ReqordFeedbackComment {
+    type?: FeedbackType;
+    severity?: FeedbackSeverity;
+    linkedTo: {
+        requirements: string[];
+        createdRequirements: string[];
+        specifications: string[];
+        createdSpecifications: string[];
+    };
+}
+export declare function parseReqordComment(body: string): ReqordFeedbackComment | null;
+export declare function buildReqordComment(metadata: ReqordFeedbackComment): string;
+export declare function upsertReqordComment(body: string, metadata: ReqordFeedbackComment): string;
+//# sourceMappingURL=reqord-comment.d.ts.map

package/dist/services/reqord-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqord-comment.d.ts","sourceRoot":"","sources":["../../src/services/reqord-comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAErE,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,qBAAqB,EAAE,MAAM,EAAE,CAAC;KACjC,CAAC;CACH;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAsB7E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAM1E;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CASR"}

package/dist/services/reqord-comment.js

@@ -0,0 +1,46 @@
+const COMMENT_PATTERN = /<!-- reqord:feedback\s+([\s\S]*?)-->/;
+export function parseReqordComment(body) {
+    const match = COMMENT_PATTERN.exec(body);
+    if (!match)
+        return null;
+    try {
+        const json = match[1].trim();
+        const data = JSON.parse(json);
+        const raw = data.linkedTo ?? {};
+        const result = {
+            linkedTo: {
+                requirements: Array.isArray(raw.requirements) ? raw.requirements : [],
+                createdRequirements: Array.isArray(raw.createdRequirements) ? raw.createdRequirements : [],
+                specifications: Array.isArray(raw.specifications) ? raw.specifications : [],
+                createdSpecifications: Array.isArray(raw.createdSpecifications) ? raw.createdSpecifications : [],
+            },
+        };
+        if (data.type)
+            result.type = data.type;
+        if (data.severity)
+            result.severity = data.severity;
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+export function buildReqordComment(metadata) {
+    const obj = {};
+    if (metadata.type)
+        obj.type = metadata.type;
+    if (metadata.severity)
+        obj.severity = metadata.severity;
+    obj.linkedTo = metadata.linkedTo;
+    return `<!-- reqord:feedback ${JSON.stringify(obj)} -->`;
+}
+export function upsertReqordComment(body, metadata) {
+    const comment = buildReqordComment(metadata);
+    if (COMMENT_PATTERN.test(body)) {
+        return body.replace(COMMENT_PATTERN, comment);
+    }
+    if (body.length === 0)
+        return comment;
+    return `${body}\n\n${comment}`;
+}
+//# sourceMappingURL=reqord-comment.js.map

package/dist/services/reqord-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqord-comment.js","sourceRoot":"","sources":["../../src/services/reqord-comment.ts"],"names":[],"mappings":"AAaA,MAAM,eAAe,GAAG,sCAAsC,CAAC;AAE/D,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAA0B;YACpC,QAAQ,EAAE;gBACR,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;gBACrE,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE;gBAC1F,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE;gBAC3E,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE;aACjG;SACF,CAAC;QACF,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvC,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAA+B;IAChE,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,QAAQ,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC5C,IAAI,QAAQ,CAAC,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACxD,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACjC,OAAO,wBAAwB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,QAA+B;IAE/B,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,OAAO,GAAG,IAAI,OAAO,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/dist/services/reqord-comment.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reqord-comment.test.d.ts.map

package/dist/services/reqord-comment.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqord-comment.test.d.ts","sourceRoot":"","sources":["../../src/services/reqord-comment.test.ts"],"names":[],"mappings":""}