@knpkv/jira-cli 0.1.1 → 1.0.0

package/dist/internal/sync/document.js

@@ -0,0 +1,173 @@
+/**
+ * Parser and serializer for strict Jira Markdown Sync Issue Documents.
+ *
+ * @internal
+ */
+import matter from "gray-matter";
+import * as yaml from "js-yaml";
+import { SyncValidationError } from "../../JiraCliError.js";
+const yamlEngine = {
+    parse: (str) => yaml.load(str) ?? {},
+    stringify: (data) => yaml.dump(data)
+};
+export const DESCRIPTION_SECTION = "Description";
+export const NEW_COMMENTS_SECTION = "New Comments";
+export const COMMENTS_SECTION = "Comments";
+export const ATTACHMENTS_SECTION = "Attachments";
+export const LOCAL_NOTES_SECTION = "Local Notes";
+const BUILT_IN_SECTIONS = new Set([
+    DESCRIPTION_SECTION,
+    NEW_COMMENTS_SECTION,
+    COMMENTS_SECTION,
+    ATTACHMENTS_SECTION,
+    LOCAL_NOTES_SECTION
+]);
+export const serializeIssueDocument = (document) => {
+    const body = [
+        `# ${document.frontMatter.issueKey}: ${document.frontMatter.summary}`,
+        "",
+        section(DESCRIPTION_SECTION, document.description),
+        ...Object.entries(document.multilineCustomFields).map(([name, content]) => section(name, content)),
+        section(NEW_COMMENTS_SECTION, serializeCommentDrafts(document.commentDrafts)),
+        section(COMMENTS_SECTION, serializeAcceptedComments(document.acceptedComments)),
+        section(ATTACHMENTS_SECTION, serializeAttachments(document.attachments)),
+        section(LOCAL_NOTES_SECTION, document.localNotes)
+    ].filter((part) => part.length > 0).join("\n");
+    return matter.stringify(body, document.frontMatter, { engines: { yaml: yamlEngine } });
+};
+export const parseIssueDocument = (path, content) => {
+    const parsed = matter(content, { engines: { yaml: yamlEngine } });
+    const frontMatter = parseFrontMatter(path, parsed.data);
+    const sections = parseSections(path, parsed.content);
+    const description = sections.get(DESCRIPTION_SECTION) ?? fail(path, `Missing ${DESCRIPTION_SECTION} section`);
+    const localNotes = sections.get(LOCAL_NOTES_SECTION) ?? "";
+    const multilineCustomFields = Object.fromEntries([...sections.entries()].filter(([name]) => !BUILT_IN_SECTIONS.has(name)));
+    return {
+        frontMatter,
+        description,
+        multilineCustomFields,
+        commentDrafts: parseCommentDrafts(path, sections.get(NEW_COMMENTS_SECTION) ?? ""),
+        acceptedComments: parseAcceptedComments(sections.get(COMMENTS_SECTION) ?? ""),
+        attachments: parseAttachments(sections.get(ATTACHMENTS_SECTION) ?? ""),
+        localNotes
+    };
+};
+const section = (name, content) => {
+    const normalized = content.trim();
+    return normalized.length > 0 ? `## ${name}\n\n${normalized}\n` : `## ${name}\n`;
+};
+const parseFrontMatter = (path, data) => {
+    const requiredString = (key) => {
+        const value = data[key];
+        if (typeof value !== "string")
+            fail(path, `Missing or invalid front matter field "${key}"`);
+        return value;
+    };
+    const nullableString = (key) => {
+        const value = data[key];
+        if (value === null || value === undefined)
+            return null;
+        if (typeof value !== "string")
+            fail(path, `Invalid front matter field "${key}"`);
+        return value;
+    };
+    const userValue = (key) => {
+        const value = data[key];
+        if (value === null || value === undefined)
+            return null;
+        if (typeof value !== "object")
+            fail(path, `Invalid user field "${key}"`);
+        const record = value;
+        if (typeof record["accountId"] !== "string" || typeof record["displayName"] !== "string") {
+            fail(path, `Invalid user field "${key}"`);
+        }
+        return {
+            accountId: record["accountId"],
+            displayName: record["displayName"]
+        };
+    };
+    const labels = data["labels"];
+    if (!Array.isArray(labels) || labels.some((label) => typeof label !== "string")) {
+        fail(path, `Missing or invalid front matter field "labels"`);
+    }
+    const customFields = data["customFields"];
+    if (customFields === null || typeof customFields !== "object" || Array.isArray(customFields)) {
+        fail(path, `Missing or invalid front matter field "customFields"`);
+    }
+    return {
+        issueId: requiredString("issueId"),
+        issueKey: requiredString("issueKey"),
+        summary: requiredString("summary"),
+        status: requiredString("status"),
+        issueType: requiredString("issueType"),
+        priority: nullableString("priority"),
+        assignee: userValue("assignee"),
+        reporter: userValue("reporter"),
+        labels: labels,
+        customFields: customFields
+    };
+};
+const parseSections = (path, content) => {
+    const lines = content.split(/\r?\n/);
+    const sections = new Map();
+    let current = null;
+    for (const line of lines) {
+        const match = /^## (.+)$/.exec(line);
+        if (match?.[1]) {
+            current = match[1].trim();
+            if (sections.has(current))
+                fail(path, `Duplicate section "${current}"`);
+            sections.set(current, []);
+        }
+        else if (current) {
+            sections.get(current)?.push(line);
+        }
+    }
+    return new Map([...sections.entries()].map(([name, body]) => [name, trimOuterBlankLines(body).join("\n")]));
+};
+const serializeCommentDrafts = (drafts) => drafts.map((draft) => `<!-- draftId: ${draft.draftId} -->\n${draft.body.trim()}`).join("\n\n");
+const parseCommentDrafts = (path, content) => {
+    if (content.trim().length === 0)
+        return [];
+    const parts = content.split(/(?=<!-- draftId: )/g).filter((part) => part.trim().length > 0);
+    return parts.map((part) => {
+        const match = /^<!-- draftId: ([^ ]+) -->\n?([\s\S]*)$/.exec(part.trim());
+        const draftId = match?.[1] ?? fail(path, "Malformed comment draft marker");
+        return { draftId, body: match?.[2]?.trim() ?? "" };
+    });
+};
+const serializeAcceptedComments = (comments) => comments.map((comment) => `### ${comment.author} - ${comment.created}\n<!-- jiraCommentId: ${comment.id} -->\n\n${comment.body.trim()}`).join("\n\n");
+const parseAcceptedComments = (content) => {
+    if (content.trim().length === 0)
+        return [];
+    const parts = content.split(/(?=^### )/gm).filter((part) => part.trim().length > 0);
+    return parts.flatMap((part) => {
+        const match = /^### (.+) - (.+)\n<!-- jiraCommentId: ([^ ]+) -->\n?([\s\S]*)$/.exec(part.trim());
+        if (!match?.[1] || !match[2] || !match[3])
+            return [];
+        return [{
+                author: match[1],
+                created: match[2],
+                id: match[3],
+                body: match[4]?.trim() ?? ""
+            }];
+    });
+};
+const serializeAttachments = (attachments) => attachments.map((attachment) => `- [${attachment.filename}](${attachment.url})`).join("\n");
+const parseAttachments = (content) => content.split(/\r?\n/).flatMap((line) => {
+    const match = /^- \[(.+)]\((.+)\)$/.exec(line.trim());
+    return match?.[1] && match[2] ? [{ filename: match[1], url: match[2] }] : [];
+});
+const trimOuterBlankLines = (lines) => {
+    let start = 0;
+    let end = lines.length;
+    while (start < end && lines[start]?.trim() === "")
+        start++;
+    while (end > start && lines[end - 1]?.trim() === "")
+        end--;
+    return lines.slice(start, end);
+};
+const fail = (path, message) => {
+    throw new SyncValidationError({ message, path });
+};
+//# sourceMappingURL=document.js.map

package/dist/internal/sync/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/internal/sync/document.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,KAAK,IAAI,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAS3D,MAAM,UAAU,GAAG;IACjB,KAAK,EAAE,CAAC,GAAW,EAAU,EAAE,CAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAY,IAAI,EAAE;IAChE,SAAS,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;CACrD,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAA;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAEhD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,mBAAmB;IACnB,oBAAoB;IACpB,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;CACpB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,QAAuB,EAAU,EAAE;IACxE,MAAM,IAAI,GAAG;QACX,KAAK,QAAQ,CAAC,WAAW,CAAC,QAAQ,KAAK,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE;QACrE,EAAE;QACF,OAAO,CAAC,mBAAmB,EAAE,QAAQ,CAAC,WAAW,CAAC;QAClD,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClG,OAAO,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAC7E,OAAO,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAC/E,OAAO,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACxE,OAAO,CAAC,mBAAmB,EAAE,QAAQ,CAAC,UAAU,CAAC;KAClD,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE9C,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;AACxF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAiB,EAAE;IACjF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;IACjE,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IACvD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAEpD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,WAAW,mBAAmB,UAAU,CAAC,CAAA;IAC7G,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAA;IAC1D,MAAM,qBAAqB,GAAG,MAAM,CAAC,WAAW,CAC9C,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CACzE,CAAA;IAED,OAAO;QACL,WAAW;QACX,WAAW;QACX,qBAAqB;QACrB,aAAa,EAAE,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC;QACjF,gBAAgB,EAAE,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC7E,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC;QACtE,UAAU;KACX,CAAA;AACH,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IACjC,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,OAAO,UAAU,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAA;AACjF,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,IAA6B,EAA4B,EAAE;IACjG,MAAM,cAAc,GAAG,CAAC,GAAW,EAAU,EAAE;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,EAAE,0CAA0C,GAAG,GAAG,CAAC,CAAA;QAC3F,OAAO,KAAe,CAAA;IACxB,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,CAAC,GAAW,EAAiB,EAAE;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,EAAE,+BAA+B,GAAG,GAAG,CAAC,CAAA;QAChF,OAAO,KAAe,CAAA;IACxB,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,EAAE,uBAAuB,GAAG,GAAG,CAAC,CAAA;QACxE,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,IAAI,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ,EAAE,CAAC;YACzF,IAAI,CAAC,IAAI,EAAE,uBAAuB,GAAG,GAAG,CAAC,CAAA;QAC3C,CAAC;QACD,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,WAAW,CAAW;YACxC,WAAW,EAAE,MAAM,CAAC,aAAa,CAAW;SAC7C,CAAA;IACH,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QAChF,IAAI,CAAC,IAAI,EAAE,gDAAgD,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,CAAA;IACzC,IAAI,YAAY,KAAK,IAAI,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7F,IAAI,CAAC,IAAI,EAAE,sDAAsD,CAAC,CAAA;IACpE,CAAC;IAED,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC;QAClC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC;QACpC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC;QAClC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC;QAChC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC;QACtC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC;QACpC,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC;QAC/B,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC;QAC/B,MAAM,EAAE,MAA+B;QACvC,YAAY,EAAE,YAAwD;KACvE,CAAA;AACH,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,OAAe,EAAuB,EAAE;IAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;IACjD,IAAI,OAAO,GAAkB,IAAI,CAAA;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YACzB,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,IAAI,CAAC,IAAI,EAAE,sBAAsB,OAAO,GAAG,CAAC,CAAA;YACvE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAC3B,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACnB,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAC7G,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,MAAmC,EAAU,EAAE,CAC7E,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,KAAK,CAAC,OAAO,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAEhG,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,OAAe,EAA+B,EAAE;IACxF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC3F,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACzE,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAA;QAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,yBAAyB,GAAG,CAAC,QAAwC,EAAU,EAAE,CACrF,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACvB,OAAO,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,OAAO,yBAAyB,OAAO,CAAC,EAAE,WAAW,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAC9G,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAEhB,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAAkC,EAAE;IAChF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACnF,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,gEAAgE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAChG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAA;QACpD,OAAO,CAAC;gBACN,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;gBAChB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBACjB,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;gBACZ,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;aAC7B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,CAAC,WAA+C,EAAU,EAAE,CACvF,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,UAAU,CAAC,QAAQ,KAAK,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAE7F,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAsC,EAAE,CAC/E,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;IACtC,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACrD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC9E,CAAC,CAAC,CAAA;AAEJ,MAAM,mBAAmB,GAAG,CAAC,KAA4B,EAAyB,EAAE;IAClF,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAA;IACtB,OAAO,KAAK,GAAG,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE;QAAE,KAAK,EAAE,CAAA;IAC1D,OAAO,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE;QAAE,GAAG,EAAE,CAAA;IAC1D,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAChC,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,OAAe,EAAS,EAAE;IACpD,MAAM,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;AAClD,CAAC,CAAA"}

package/dist/internal/sync/fieldValues.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Field value helpers for Jira Markdown Sync reconciliation.
+ *
+ * @internal
+ */
+import type { CascadingFieldValue, OptionFieldValue, SyncFieldValue, UserFieldValue } from "./types.js";
+export type CompleteListItem = string | number | boolean | UserFieldValue | OptionFieldValue;
+export type CompleteListValue = ReadonlyArray<CompleteListItem>;
+export interface CanonicalFieldValueOptions {
+    readonly ordered?: boolean | undefined;
+}
+export declare const explicitClear: null;
+export declare const isExplicitClear: (value: unknown) => value is null;
+export declare const userFieldValue: (accountId: string, displayName: string) => UserFieldValue;
+export declare const makeUserFieldValue: (accountId: string, displayName: string) => UserFieldValue;
+export declare const optionFieldValue: (value: string, id?: string) => OptionFieldValue;
+export declare const makeOptionFieldValue: (value: string, id?: string) => OptionFieldValue;
+export declare const cascadingFieldValue: (parent: OptionFieldValue, child?: OptionFieldValue) => CascadingFieldValue;
+export declare const makeCascadingFieldValue: (parent: OptionFieldValue, child?: OptionFieldValue) => CascadingFieldValue;
+export declare const completeListValue: (items: Iterable<CompleteListItem>, options?: CanonicalFieldValueOptions) => CompleteListValue;
+export declare const makeCompleteListValue: (items: Iterable<CompleteListItem>, options?: CanonicalFieldValueOptions) => CompleteListValue;
+export declare const isUserFieldValue: (value: unknown) => value is UserFieldValue;
+export declare const isOptionFieldValue: (value: unknown) => value is OptionFieldValue;
+export declare const isCascadingFieldValue: (value: unknown) => value is CascadingFieldValue;
+export declare const isCompleteListValue: (value: unknown) => value is CompleteListValue;
+export declare const canonicalFieldOrder: <A extends CompleteListItem>(items: ReadonlyArray<A>, options?: CanonicalFieldValueOptions) => ReadonlyArray<A>;
+export declare const canonicalizeFieldValue: (value: SyncFieldValue, options?: CanonicalFieldValueOptions) => SyncFieldValue;
+export declare const fieldValuesEqual: (left: SyncFieldValue, right: SyncFieldValue, options?: CanonicalFieldValueOptions) => boolean;
+export declare const compareCompleteListItems: (left: CompleteListItem, right: CompleteListItem) => number;
+//# sourceMappingURL=fieldValues.d.ts.map

package/dist/internal/sync/fieldValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldValues.d.ts","sourceRoot":"","sources":["../../../src/internal/sync/fieldValues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEvG,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,gBAAgB,CAAA;AAE5F,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAA;AAE/D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACvC;AAED,eAAO,MAAM,aAAa,MAAO,CAAA;AAEjC,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,IAAsB,CAAA;AAEhF,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,KAAG,cAGtE,CAAA;AAEF,eAAO,MAAM,kBAAkB,cALW,MAAM,eAAe,MAAM,KAAG,cAKxB,CAAA;AAEhD,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,gBAChB,CAAA;AAE9C,eAAO,MAAM,oBAAoB,UAHO,MAAM,OAAO,MAAM,KAAG,gBAGV,CAAA;AAEpD,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,gBAAgB,EACxB,QAAQ,gBAAgB,KACvB,mBAA2E,CAAA;AAE9E,eAAO,MAAM,uBAAuB,WAJ1B,gBAAgB,UAChB,gBAAgB,KACvB,mBAEuD,CAAA;AAE1D,eAAO,MAAM,iBAAiB,GAC5B,OAAO,QAAQ,CAAC,gBAAgB,CAAC,EACjC,UAAS,0BAA+B,KACvC,iBAAoE,CAAA;AAEvE,eAAO,MAAM,qBAAqB,UAJzB,QAAQ,CAAC,gBAAgB,CAAC,YACxB,0BAA0B,KAClC,iBAEmD,CAAA;AAEtD,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAG1D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBAI5D,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,mBAI/D,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,iBACL,CAAA;AAEzD,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,gBAAgB,EAC5D,OAAO,aAAa,CAAC,CAAC,CAAC,EACvB,UAAS,0BAA+B,KACvC,aAAa,CAAC,CAAC,CAAsF,CAAA;AAExG,eAAO,MAAM,sBAAsB,GACjC,OAAO,cAAc,EACrB,UAAS,0BAA+B,KACvC,cAUF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,MAAM,cAAc,EACpB,OAAO,cAAc,EACrB,UAAS,0BAA+B,KACvC,OAA2F,CAAA;AAE9F,eAAO,MAAM,wBAAwB,GAAI,MAAM,gBAAgB,EAAE,OAAO,gBAAgB,KAAG,MAI1F,CAAA"}

package/dist/internal/sync/fieldValues.js

@@ -0,0 +1,91 @@
+export const explicitClear = null;
+export const isExplicitClear = (value) => value === null;
+export const userFieldValue = (accountId, displayName) => ({
+    accountId,
+    displayName
+});
+export const makeUserFieldValue = userFieldValue;
+export const optionFieldValue = (value, id) => id === undefined ? { value } : { id, value };
+export const makeOptionFieldValue = optionFieldValue;
+export const cascadingFieldValue = (parent, child) => child === undefined ? { parent } : { parent, child };
+export const makeCascadingFieldValue = cascadingFieldValue;
+export const completeListValue = (items, options = {}) => canonicalFieldOrder(Array.from(items), options);
+export const makeCompleteListValue = completeListValue;
+export const isUserFieldValue = (value) => {
+    if (!isRecord(value))
+        return false;
+    return typeof value["accountId"] === "string" && typeof value["displayName"] === "string";
+};
+export const isOptionFieldValue = (value) => {
+    if (!isRecord(value) || typeof value["value"] !== "string")
+        return false;
+    const id = value["id"];
+    return id === undefined || typeof id === "string";
+};
+export const isCascadingFieldValue = (value) => {
+    if (!isRecord(value) || !isOptionFieldValue(value["parent"]))
+        return false;
+    const child = value["child"];
+    return child === undefined || isOptionFieldValue(child);
+};
+export const isCompleteListValue = (value) => Array.isArray(value) && value.every(isCompleteListItem);
+export const canonicalFieldOrder = (items, options = {}) => options.ordered === true ? [...items] : [...items].sort(compareCompleteListItems);
+export const canonicalizeFieldValue = (value, options = {}) => {
+    if (Array.isArray(value))
+        return canonicalFieldOrder(value, options);
+    if (isCascadingFieldValue(value)) {
+        return value.child === undefined
+            ? { parent: canonicalizeOption(value.parent) }
+            : { parent: canonicalizeOption(value.parent), child: canonicalizeOption(value.child) };
+    }
+    if (isUserFieldValue(value))
+        return { accountId: value.accountId, displayName: value.displayName };
+    if (isOptionFieldValue(value))
+        return canonicalizeOption(value);
+    return value;
+};
+export const fieldValuesEqual = (left, right, options = {}) => canonicalFieldValueKey(left, options) === canonicalFieldValueKey(right, options);
+export const compareCompleteListItems = (left, right) => {
+    const leftKey = completeListItemOrderKey(left);
+    const rightKey = completeListItemOrderKey(right);
+    return leftKey.localeCompare(rightKey, "en", { numeric: true });
+};
+const canonicalizeOption = (value) => value.id === undefined ? { value: value.value } : { id: value.id, value: value.value };
+const canonicalFieldValueKey = (value, options) => {
+    if (value === null)
+        return "clear:";
+    if (Array.isArray(value)) {
+        return `list:${canonicalFieldOrder(value, options).map(completeListItemOrderKey).join("\u0000")}`;
+    }
+    if (isCascadingFieldValue(value)) {
+        return `cascading:${optionOrderKey(value.parent)}\u0000${value.child === undefined ? "" : optionOrderKey(value.child)}`;
+    }
+    if (isUserFieldValue(value))
+        return userOrderKey(value);
+    if (isOptionFieldValue(value))
+        return optionOrderKey(value);
+    return `${typeof value}:${String(value)}`;
+};
+const completeListItemOrderKey = (value) => {
+    if (isUserFieldValue(value))
+        return userOrderKey(value);
+    if (isOptionFieldValue(value))
+        return optionOrderKey(value);
+    return `${typeof value}:${String(value)}`;
+};
+const userOrderKey = (value) => `user:${value.displayName.toLocaleLowerCase("en")}\u0000${value.accountId}`;
+const optionOrderKey = (value) => `option:${value.value.toLocaleLowerCase("en")}\u0000${value.id ?? ""}`;
+const isCompleteListItem = (value) => {
+    switch (typeof value) {
+        case "string":
+        case "number":
+        case "boolean":
+            return true;
+        case "object":
+            return isUserFieldValue(value) || isOptionFieldValue(value);
+        default:
+            return false;
+    }
+};
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+//# sourceMappingURL=fieldValues.js.map

package/dist/internal/sync/fieldValues.js.map

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

package/dist/internal/sync/manifest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sync Manifest helpers.
+ *
+ * @internal
+ */
+import * as Effect from "effect/Effect";
+import { SyncValidationError, SyncWorkspaceError } from "../../JiraCliError.js";
+import type { SyncManifest } from "./types.js";
+export declare const makeEmptyManifest: (siteUrl: string) => SyncManifest;
+export declare const parseSyncManifest: (path: string, content: string) => Effect.Effect<SyncManifest, SyncWorkspaceError | SyncValidationError>;
+export declare const serializeSyncManifest: (manifest: SyncManifest) => string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/internal/sync/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/internal/sync/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,YAIlD,CAAA;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,SAAS,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,kBAAkB,GAAG,mBAAmB,CASnE,CAAA;AAEJ,eAAO,MAAM,qBAAqB,GAAI,UAAU,YAAY,KAAG,MAAkD,CAAA"}

package/dist/internal/sync/manifest.js

@@ -0,0 +1,23 @@
+/**
+ * Sync Manifest helpers.
+ *
+ * @internal
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { SyncValidationError, SyncWorkspaceError } from "../../JiraCliError.js";
+import { SyncManifestSchema } from "./schemas.js";
+export const makeEmptyManifest = (siteUrl) => ({
+    version: 1,
+    siteUrl,
+    issues: []
+});
+export const parseSyncManifest = (path, content) => Effect.gen(function* () {
+    const raw = yield* Effect.try({
+        try: () => JSON.parse(content),
+        catch: (cause) => new SyncWorkspaceError({ message: "Failed to parse Sync Manifest JSON", path, cause })
+    });
+    return yield* Schema.decodeUnknownEffect(SyncManifestSchema)(raw).pipe(Effect.mapError((cause) => new SyncValidationError({ message: "Invalid Sync Manifest", path, cause })));
+});
+export const serializeSyncManifest = (manifest) => `${JSON.stringify(manifest, null, 2)}\n`;
+//# sourceMappingURL=manifest.js.map

package/dist/internal/sync/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/internal/sync/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAGjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAgB,EAAE,CAAC,CAAC;IACnE,OAAO,EAAE,CAAC;IACV,OAAO;IACP,MAAM,EAAE,EAAE;CACX,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAY,EACZ,OAAe,EACwD,EAAE,CACzE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC5B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY;QACzC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;KACzG,CAAC,CAAA;IACF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CACpE,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CACvG,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAsB,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA"}

package/dist/internal/sync/paths.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Path helpers for Jira Markdown Sync workspace files.
+ *
+ * @internal
+ */
+import type * as Path from "effect/Path";
+import type { WorkspaceConfig } from "./types.js";
+export declare const METADATA_DIR = ".jira-md";
+export declare const DEFAULT_DOCUMENTS_DIR = "issues";
+export declare const CONFIG_FILE = "config.yaml";
+export declare const MANIFEST_FILE = "manifest.json";
+export declare const BASELINES_DIR = "baselines";
+export declare const HISTORY_DIR = "history";
+export interface SyncWorkspacePaths {
+    readonly root: string;
+    readonly documentsDir: string;
+    readonly metadataDir: string;
+    readonly configFile: string;
+    readonly manifestFile: string;
+    readonly baselinesDir: string;
+    readonly historyDir: string;
+}
+export declare const resolveWorkspacePaths: (path: Path.Path, root: string, config?: Pick<WorkspaceConfig, "documentsDir">) => SyncWorkspacePaths;
+export declare const baselineFilePath: (path: Path.Path, paths: SyncWorkspacePaths, issueId: string) => string;
+export declare const conventionDocumentPath: (path: Path.Path, paths: SyncWorkspacePaths, issueKey: string) => string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/internal/sync/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/internal/sync/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,eAAO,MAAM,YAAY,aAAa,CAAA;AACtC,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,WAAW,gBAAgB,CAAA;AACxC,eAAO,MAAM,aAAa,kBAAkB,CAAA;AAC5C,eAAO,MAAM,aAAa,cAAc,CAAA;AACxC,eAAO,MAAM,WAAW,YAAY,CAAA;AAEpC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,eAAO,MAAM,qBAAqB,GAChC,MAAM,IAAI,CAAC,IAAI,EACf,MAAM,MAAM,EACZ,SAAS,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,KAC7C,kBAYF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,kBAAkB,EAAE,SAAS,MAAM,KAAG,MAC7C,CAAA;AAElD,eAAO,MAAM,sBAAsB,GAAI,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,kBAAkB,EAAE,UAAU,MAAM,KAAG,MACrD,CAAA"}

package/dist/internal/sync/paths.js

@@ -0,0 +1,22 @@
+export const METADATA_DIR = ".jira-md";
+export const DEFAULT_DOCUMENTS_DIR = "issues";
+export const CONFIG_FILE = "config.yaml";
+export const MANIFEST_FILE = "manifest.json";
+export const BASELINES_DIR = "baselines";
+export const HISTORY_DIR = "history";
+export const resolveWorkspacePaths = (path, root, config) => {
+    const documentsDir = path.resolve(root, config?.documentsDir ?? DEFAULT_DOCUMENTS_DIR);
+    const metadataDir = path.resolve(root, METADATA_DIR);
+    return {
+        root: path.resolve(root),
+        documentsDir,
+        metadataDir,
+        configFile: path.join(metadataDir, CONFIG_FILE),
+        manifestFile: path.join(metadataDir, MANIFEST_FILE),
+        baselinesDir: path.join(metadataDir, BASELINES_DIR),
+        historyDir: path.join(metadataDir, HISTORY_DIR)
+    };
+};
+export const baselineFilePath = (path, paths, issueId) => path.join(paths.baselinesDir, `${issueId}.json`);
+export const conventionDocumentPath = (path, paths, issueKey) => path.join(paths.documentsDir, `${issueKey}.md`);
+//# sourceMappingURL=paths.js.map

package/dist/internal/sync/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/internal/sync/paths.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAA;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAA;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAA;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAA;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAA;AAYpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,IAAe,EACf,IAAY,EACZ,MAA8C,EAC1B,EAAE;IACtB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,IAAI,qBAAqB,CAAC,CAAA;IACtF,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACpD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QACxB,YAAY;QACZ,WAAW;QACX,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;QAC/C,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;QACnD,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;QACnD,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;KAChD,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAe,EAAE,KAAyB,EAAE,OAAe,EAAU,EAAE,CACtG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,OAAO,OAAO,CAAC,CAAA;AAElD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAe,EAAE,KAAyB,EAAE,QAAgB,EAAU,EAAE,CAC7G,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,QAAQ,KAAK,CAAC,CAAA"}

package/dist/internal/sync/schemas.d.ts

@@ -0,0 +1,128 @@
+import * as Schema from "effect/Schema";
+export declare const FieldShapeSchema: Schema.Literals<readonly ["text", "multilineText", "number", "boolean", "date", "singleSelect", "multiSelect", "user", "cascadingSelect"]>;
+export declare const RequestedCustomFieldSchema: Schema.Struct<{
+    readonly displayName: Schema.String;
+    readonly fieldId: Schema.optional<Schema.String>;
+    readonly shape: Schema.Literals<readonly ["text", "multilineText", "number", "boolean", "date", "singleSelect", "multiSelect", "user", "cascadingSelect"]>;
+    readonly ordered: Schema.optional<Schema.Boolean>;
+}>;
+export declare const WorkspaceConfigSchema: Schema.Struct<{
+    readonly version: Schema.withDecodingDefaultTypeKey<Schema.Literal<1>, never>;
+    readonly siteUrl: Schema.String;
+    readonly documentsDir: Schema.withDecodingDefaultTypeKey<Schema.String, never>;
+    readonly customFields: Schema.withDecodingDefaultTypeKey<Schema.$Array<Schema.Struct<{
+        readonly displayName: Schema.String;
+        readonly fieldId: Schema.optional<Schema.String>;
+        readonly shape: Schema.Literals<readonly ["text", "multilineText", "number", "boolean", "date", "singleSelect", "multiSelect", "user", "cascadingSelect"]>;
+        readonly ordered: Schema.optional<Schema.Boolean>;
+    }>>, never>;
+}>;
+export declare const ManifestIssueSchema: Schema.Struct<{
+    readonly issueId: Schema.String;
+    readonly issueKey: Schema.String;
+    readonly documentPath: Schema.String;
+    readonly filenameMode: Schema.Literals<readonly ["convention", "custom"]>;
+}>;
+export declare const SyncManifestSchema: Schema.Struct<{
+    readonly version: Schema.Literal<1>;
+    readonly siteUrl: Schema.String;
+    readonly issues: Schema.$Array<Schema.Struct<{
+        readonly issueId: Schema.String;
+        readonly issueKey: Schema.String;
+        readonly documentPath: Schema.String;
+        readonly filenameMode: Schema.Literals<readonly ["convention", "custom"]>;
+    }>>;
+}>;
+export declare const SyncFieldValueSchema: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.Null, Schema.Struct<{
+    readonly accountId: Schema.String;
+    readonly displayName: Schema.String;
+}>, Schema.Struct<{
+    readonly id: Schema.optional<Schema.String>;
+    readonly value: Schema.String;
+}>, Schema.Struct<{
+    readonly parent: Schema.Struct<{
+        readonly id: Schema.optional<Schema.String>;
+        readonly value: Schema.String;
+    }>;
+    readonly child: Schema.optional<Schema.Struct<{
+        readonly id: Schema.optional<Schema.String>;
+        readonly value: Schema.String;
+    }>>;
+}>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.Struct<{
+    readonly accountId: Schema.String;
+    readonly displayName: Schema.String;
+}>, Schema.Struct<{
+    readonly id: Schema.optional<Schema.String>;
+    readonly value: Schema.String;
+}>]>>]>;
+export declare const BaselineCustomFieldSchema: Schema.Struct<{
+    readonly fieldId: Schema.String;
+    readonly displayName: Schema.String;
+    readonly shape: Schema.Literals<readonly ["text", "multilineText", "number", "boolean", "date", "singleSelect", "multiSelect", "user", "cascadingSelect"]>;
+    readonly value: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.Null, Schema.Struct<{
+        readonly accountId: Schema.String;
+        readonly displayName: Schema.String;
+    }>, Schema.Struct<{
+        readonly id: Schema.optional<Schema.String>;
+        readonly value: Schema.String;
+    }>, Schema.Struct<{
+        readonly parent: Schema.Struct<{
+            readonly id: Schema.optional<Schema.String>;
+            readonly value: Schema.String;
+        }>;
+        readonly child: Schema.optional<Schema.Struct<{
+            readonly id: Schema.optional<Schema.String>;
+            readonly value: Schema.String;
+        }>>;
+    }>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.Struct<{
+        readonly accountId: Schema.String;
+        readonly displayName: Schema.String;
+    }>, Schema.Struct<{
+        readonly id: Schema.optional<Schema.String>;
+        readonly value: Schema.String;
+    }>]>>]>;
+}>;
+export declare const SyncBaselineSchema: Schema.Struct<{
+    readonly version: Schema.Literal<1>;
+    readonly issueId: Schema.String;
+    readonly issueKey: Schema.String;
+    readonly fields: Schema.Struct<{
+        readonly summary: Schema.String;
+        readonly description: Schema.String;
+        readonly labels: Schema.$Array<Schema.String>;
+        readonly customFields: Schema.$Record<Schema.String, Schema.Struct<{
+            readonly fieldId: Schema.String;
+            readonly displayName: Schema.String;
+            readonly shape: Schema.Literals<readonly ["text", "multilineText", "number", "boolean", "date", "singleSelect", "multiSelect", "user", "cascadingSelect"]>;
+            readonly value: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.Null, Schema.Struct<{
+                readonly accountId: Schema.String;
+                readonly displayName: Schema.String;
+            }>, Schema.Struct<{
+                readonly id: Schema.optional<Schema.String>;
+                readonly value: Schema.String;
+            }>, Schema.Struct<{
+                readonly parent: Schema.Struct<{
+                    readonly id: Schema.optional<Schema.String>;
+                    readonly value: Schema.String;
+                }>;
+                readonly child: Schema.optional<Schema.Struct<{
+                    readonly id: Schema.optional<Schema.String>;
+                    readonly value: Schema.String;
+                }>>;
+            }>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.Struct<{
+                readonly accountId: Schema.String;
+                readonly displayName: Schema.String;
+            }>, Schema.Struct<{
+                readonly id: Schema.optional<Schema.String>;
+                readonly value: Schema.String;
+            }>]>>]>;
+        }>>;
+    }>;
+    readonly comments: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+    }>>;
+}>;
+export type WorkspaceConfig = Schema.Schema.Type<typeof WorkspaceConfigSchema>;
+export type SyncManifest = Schema.Schema.Type<typeof SyncManifestSchema>;
+export type SyncBaseline = Schema.Schema.Type<typeof SyncBaselineSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/internal/sync/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/internal/sync/schemas.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AASvC,eAAO,MAAM,gBAAgB,4IAAgC,CAAA;AAE7D,eAAO,MAAM,0BAA0B;;;;;EAKrC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;EAOhC,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;EAI7B,CAAA;AAyBF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;OAS/B,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;EAKpC,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW7B,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAC9E,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAA;AACxE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAA"}