@imgly/codesign-mcp 0.1.5 → 0.1.6

package/dist/test/scripts/changelog-add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-add.js","sourceRoot":"","sources":["../../../scripts/changelog-add.ts"],"names":[],"mappings":";AACA,uDAAuD;AACvD,gEAAgE;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,SAAS,GAAG,IAAI;SACnB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,GAAG,SAAS,KAAK,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAI9B;IACC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;IAC/D,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CACX,wEAAwE,CACzE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;QAC5B,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC;QAC9C,UAAU;QACV,IAAI;KACL,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,wBAAwB,CAAC,CAAC;AACzD,CAAC;AAED,IACE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACf,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EACvD,CAAC;IACD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC5B,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["#!/usr/bin/env node\n// Create a new changelog-next entry from the template.\n// Run via `node --experimental-strip-types` (see package.json).\nimport { copyFile, access } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\n\nexport function entryFileName(name: string): string {\n  const sanitized = name\n    .replace(/[\\\\/]/g, '-')\n    .replace(/^-+/, '')\n    .replace(/\\.md$/i, '');\n  return `${sanitized}.md`;\n}\n\nexport async function addEntry(opts: {\n  templatePath: string;\n  entriesDir: string;\n  name: string;\n}): Promise<string> {\n  const target = join(opts.entriesDir, entryFileName(opts.name));\n  let exists = true;\n  try {\n    await access(target);\n  } catch {\n    exists = false;\n  }\n  if (exists) throw new Error(`entry already exists: ${target}`);\n  await copyFile(opts.templatePath, target);\n  return target;\n}\n\nasync function main(): Promise<void> {\n  const name = process.argv[2];\n  if (!name) {\n    console.error(\n      'usage: node --experimental-strip-types scripts/changelog-add.ts <name>'\n    );\n    process.exit(1);\n  }\n  const here = dirname(fileURLToPath(import.meta.url));\n  const entriesDir = join(here, '..', 'changelog-next');\n  const target = await addEntry({\n    templatePath: join(entriesDir, '-template.md'),\n    entriesDir,\n    name\n  });\n  console.log(`created ${target} — edit it and commit.`);\n}\n\nif (\n  process.argv[1] &&\n  import.meta.url === pathToFileURL(process.argv[1]).href\n) {\n  main().catch((err: unknown) => {\n    console.error(err instanceof Error ? err.message : String(err));\n    process.exit(1);\n  });\n}\n"]}

package/dist/test/scripts/changelog-collate.d.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+export interface ChangelogEntry {
+    name: string;
+    type: string;
+    breaking: boolean;
+    body: string;
+}
+export interface GroupedEntries {
+    breaking: string[];
+    changes: string[];
+    fixed: string[];
+    deprecated: string[];
+}
+export declare function parseEntry(text: string): {
+    type: string;
+    breaking: boolean;
+    body: string;
+};
+export declare function groupEntries(entries: ChangelogEntry[]): GroupedEntries;
+export declare function renderVersionSection(version: string, grouped: GroupedEntries, absorbedBody?: string): string;
+export declare function extractUnreleased(md: string): {
+    body: string;
+    md: string;
+};
+export declare function hasVersion(md: string, version: string): boolean;
+export declare function insertVersionSection(md: string, sectionMd: string): string;
+export type CollateResult = {
+    noop: true;
+} | {
+    noop: false;
+    section: string;
+};
+export declare function collateFiles(opts: {
+    entriesDir: string;
+    changelogPath: string;
+    version: string;
+}): Promise<CollateResult>;
+//# sourceMappingURL=changelog-collate.d.ts.map

package/dist/test/scripts/changelog-collate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-collate.d.ts","sourceRoot":"","sources":["../../../scripts/changelog-collate.ts"],"names":[],"mappings":";AAKA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AASD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAiBA;AAGD,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,CActE;AASD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,YAAY,SAAK,GAChB,MAAM,CAQR;AAmCD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAO1E;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI1E;AAMD,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAqB9E,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBzB"}

package/dist/test/scripts/changelog-collate.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+// Collate changelog-next/*.md entries into CHANGELOG.md under `## Version <v>`.
+// Run via `node --experimental-strip-types` (see package.json) — no build step.
+// See docs/specs/2026-06-30-changelog-system-design.md.
+const FENCE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+// Minimal frontmatter read for the two scalar keys we need. We intentionally do
+// NOT reuse src/frontmatter.ts: it whitelists name/description, and importing it
+// (a `.js` specifier resolving to src/frontmatter.js) would require a build
+// before this script could run. Keeping it self-contained keeps collate
+// build-free. Lines starting with `#` are comments; inline `# ...` is stripped.
+export function parseEntry(text) {
+    const match = text.match(FENCE);
+    const block = match ? match[1] : '';
+    const body = (match ? text.slice(match[0].length) : text).trim();
+    let type = '';
+    let breaking = false;
+    for (const line of block.split(/\r?\n/)) {
+        const m = line.match(/^(type|breaking)\s*:\s*(.*)$/);
+        if (!m)
+            continue;
+        const value = m[2]
+            .replace(/\s+#.*$/, '')
+            .trim()
+            .toLowerCase();
+        if (m[1] === 'type')
+            type = value;
+        else
+            breaking = value === 'true';
+    }
+    return { type, breaking, body };
+}
+// Breaking entries go to `breaking` only (Option A). Unknown type -> changes.
+export function groupEntries(entries) {
+    const grouped = {
+        breaking: [],
+        changes: [],
+        fixed: [],
+        deprecated: []
+    };
+    for (const e of [...entries].sort((a, b) => a.name.localeCompare(b.name))) {
+        if (e.breaking)
+            grouped.breaking.push(e.body);
+        else if (e.type === 'fixed')
+            grouped.fixed.push(e.body);
+        else if (e.type === 'deprecated')
+            grouped.deprecated.push(e.body);
+        else
+            grouped.changes.push(e.body);
+    }
+    return grouped;
+}
+const SECTIONS = [
+    { key: 'breaking', heading: '### ⚠ Breaking' },
+    { key: 'changes', heading: '### Changes' },
+    { key: 'fixed', heading: '### Fixed' },
+    { key: 'deprecated', heading: '### Deprecated' }
+];
+export function renderVersionSection(version, grouped, absorbedBody = '') {
+    const parts = [`## Version ${version}`];
+    for (const { key, heading } of SECTIONS) {
+        const bodies = grouped[key];
+        if (bodies.length)
+            parts.push(`${heading}\n\n${bodies.join('\n')}`);
+    }
+    if (absorbedBody.trim())
+        parts.push(absorbedBody.trim());
+    return parts.join('\n\n') + '\n';
+}
+// Split a CHANGELOG into the leading header (before the first `## `) and the
+// `## `-delimited sections. `### ` subheadings stay inside a section's body.
+function parseSections(md) {
+    let header = '';
+    const sections = [];
+    for (const part of md.split(/^(?=## )/m)) {
+        if (part.startsWith('## ')) {
+            const nl = part.indexOf('\n');
+            const heading = (nl === -1 ? part : part.slice(0, nl)).trim();
+            const body = (nl === -1 ? '' : part.slice(nl + 1)).trim();
+            sections.push({ heading, body });
+        }
+        else {
+            header = part.replace(/\s+$/, '');
+        }
+    }
+    return { header, sections };
+}
+function renderChangelog(header, sections) {
+    const blocks = sections.map((s) => s.body ? `${s.heading}\n\n${s.body}` : s.heading);
+    return [header, ...blocks].filter(Boolean).join('\n\n') + '\n';
+}
+export function extractUnreleased(md) {
+    const { header, sections } = parseSections(md);
+    const idx = sections.findIndex((s) => s.heading === '## Unreleased');
+    if (idx === -1)
+        return { body: '', md };
+    const body = sections[idx].body;
+    sections.splice(idx, 1);
+    return { body, md: renderChangelog(header, sections) };
+}
+export function hasVersion(md, version) {
+    return parseSections(md).sections.some((s) => s.heading === `## Version ${version}`);
+}
+export function insertVersionSection(md, sectionMd) {
+    const { header, sections } = parseSections(md);
+    const newSection = parseSections(sectionMd).sections[0];
+    return renderChangelog(header, [newSection, ...sections]);
+}
+import { readFile, writeFile, readdir, rm } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+async function readEntries(entriesDir) {
+    let names;
+    try {
+        names = await readdir(entriesDir);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+    const files = names
+        .filter((n) => n.endsWith('.md') && !n.startsWith('-'))
+        .sort();
+    const entries = [];
+    for (const name of files) {
+        const text = await readFile(join(entriesDir, name), 'utf8');
+        entries.push({ name, ...parseEntry(text) });
+    }
+    return entries;
+}
+export async function collateFiles(opts) {
+    const { entriesDir, changelogPath, version } = opts;
+    const entries = await readEntries(entriesDir);
+    const existing = await readFile(changelogPath, 'utf8');
+    const { body: unreleasedBody, md: mdNoUnreleased } = extractUnreleased(existing);
+    if (entries.length === 0 && !unreleasedBody)
+        return { noop: true };
+    if (hasVersion(mdNoUnreleased, version)) {
+        throw new Error(`## Version ${version} already exists in ${changelogPath}`);
+    }
+    const section = renderVersionSection(version, groupEntries(entries), unreleasedBody);
+    await writeFile(changelogPath, insertVersionSection(mdNoUnreleased, section));
+    await Promise.all(entries.map((e) => rm(join(entriesDir, e.name))));
+    return { noop: false, section };
+}
+async function main() {
+    const version = process.argv[2];
+    if (!version) {
+        console.error('usage: node --experimental-strip-types scripts/changelog-collate.ts <version>');
+        process.exit(1);
+    }
+    const here = dirname(fileURLToPath(import.meta.url));
+    const result = await collateFiles({
+        entriesDir: join(here, '..', 'changelog-next'),
+        changelogPath: join(here, '..', 'CHANGELOG.md'),
+        version
+    });
+    if (result.noop) {
+        console.error('changelog: nothing to collate');
+        return;
+    }
+    process.stdout.write(result.section);
+}
+if (process.argv[1] &&
+    import.meta.url === pathToFileURL(process.argv[1]).href) {
+    main().catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=changelog-collate.js.map

package/dist/test/scripts/changelog-collate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-collate.js","sourceRoot":"","sources":["../../../scripts/changelog-collate.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n// Collate changelog-next/*.md entries into CHANGELOG.md under `## Version <v>`.\n// Run via `node --experimental-strip-types` (see package.json) — no build step.\n// See docs/specs/2026-06-30-changelog-system-design.md.\n\nexport interface ChangelogEntry {\n  name: string;\n  type: string;\n  breaking: boolean;\n  body: string;\n}\n\nexport interface GroupedEntries {\n  breaking: string[];\n  changes: string[];\n  fixed: string[];\n  deprecated: string[];\n}\n\nconst FENCE = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?/;\n\n// Minimal frontmatter read for the two scalar keys we need. We intentionally do\n// NOT reuse src/frontmatter.ts: it whitelists name/description, and importing it\n// (a `.js` specifier resolving to src/frontmatter.js) would require a build\n// before this script could run. Keeping it self-contained keeps collate\n// build-free. Lines starting with `#` are comments; inline `# ...` is stripped.\nexport function parseEntry(text: string): {\n  type: string;\n  breaking: boolean;\n  body: string;\n} {\n  const match = text.match(FENCE);\n  const block = match ? match[1] : '';\n  const body = (match ? text.slice(match[0].length) : text).trim();\n  let type = '';\n  let breaking = false;\n  for (const line of block.split(/\\r?\\n/)) {\n    const m = line.match(/^(type|breaking)\\s*:\\s*(.*)$/);\n    if (!m) continue;\n    const value = m[2]\n      .replace(/\\s+#.*$/, '')\n      .trim()\n      .toLowerCase();\n    if (m[1] === 'type') type = value;\n    else breaking = value === 'true';\n  }\n  return { type, breaking, body };\n}\n\n// Breaking entries go to `breaking` only (Option A). Unknown type -> changes.\nexport function groupEntries(entries: ChangelogEntry[]): GroupedEntries {\n  const grouped: GroupedEntries = {\n    breaking: [],\n    changes: [],\n    fixed: [],\n    deprecated: []\n  };\n  for (const e of [...entries].sort((a, b) => a.name.localeCompare(b.name))) {\n    if (e.breaking) grouped.breaking.push(e.body);\n    else if (e.type === 'fixed') grouped.fixed.push(e.body);\n    else if (e.type === 'deprecated') grouped.deprecated.push(e.body);\n    else grouped.changes.push(e.body);\n  }\n  return grouped;\n}\n\nconst SECTIONS: { key: keyof GroupedEntries; heading: string }[] = [\n  { key: 'breaking', heading: '### ⚠ Breaking' },\n  { key: 'changes', heading: '### Changes' },\n  { key: 'fixed', heading: '### Fixed' },\n  { key: 'deprecated', heading: '### Deprecated' }\n];\n\nexport function renderVersionSection(\n  version: string,\n  grouped: GroupedEntries,\n  absorbedBody = ''\n): string {\n  const parts = [`## Version ${version}`];\n  for (const { key, heading } of SECTIONS) {\n    const bodies = grouped[key];\n    if (bodies.length) parts.push(`${heading}\\n\\n${bodies.join('\\n')}`);\n  }\n  if (absorbedBody.trim()) parts.push(absorbedBody.trim());\n  return parts.join('\\n\\n') + '\\n';\n}\n\ninterface MarkdownSection {\n  heading: string;\n  body: string;\n}\n\n// Split a CHANGELOG into the leading header (before the first `## `) and the\n// `## `-delimited sections. `### ` subheadings stay inside a section's body.\nfunction parseSections(md: string): {\n  header: string;\n  sections: MarkdownSection[];\n} {\n  let header = '';\n  const sections: MarkdownSection[] = [];\n  for (const part of md.split(/^(?=## )/m)) {\n    if (part.startsWith('## ')) {\n      const nl = part.indexOf('\\n');\n      const heading = (nl === -1 ? part : part.slice(0, nl)).trim();\n      const body = (nl === -1 ? '' : part.slice(nl + 1)).trim();\n      sections.push({ heading, body });\n    } else {\n      header = part.replace(/\\s+$/, '');\n    }\n  }\n  return { header, sections };\n}\n\nfunction renderChangelog(header: string, sections: MarkdownSection[]): string {\n  const blocks = sections.map((s) =>\n    s.body ? `${s.heading}\\n\\n${s.body}` : s.heading\n  );\n  return [header, ...blocks].filter(Boolean).join('\\n\\n') + '\\n';\n}\n\nexport function extractUnreleased(md: string): { body: string; md: string } {\n  const { header, sections } = parseSections(md);\n  const idx = sections.findIndex((s) => s.heading === '## Unreleased');\n  if (idx === -1) return { body: '', md };\n  const body = sections[idx].body;\n  sections.splice(idx, 1);\n  return { body, md: renderChangelog(header, sections) };\n}\n\nexport function hasVersion(md: string, version: string): boolean {\n  return parseSections(md).sections.some(\n    (s) => s.heading === `## Version ${version}`\n  );\n}\n\nexport function insertVersionSection(md: string, sectionMd: string): string {\n  const { header, sections } = parseSections(md);\n  const newSection = parseSections(sectionMd).sections[0];\n  return renderChangelog(header, [newSection, ...sections]);\n}\n\nimport { readFile, writeFile, readdir, rm } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\n\nexport type CollateResult = { noop: true } | { noop: false; section: string };\n\nasync function readEntries(entriesDir: string): Promise<ChangelogEntry[]> {\n  let names: string[];\n  try {\n    names = await readdir(entriesDir);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === 'ENOENT') return [];\n    throw err;\n  }\n  const files = names\n    .filter((n) => n.endsWith('.md') && !n.startsWith('-'))\n    .sort();\n  const entries: ChangelogEntry[] = [];\n  for (const name of files) {\n    const text = await readFile(join(entriesDir, name), 'utf8');\n    entries.push({ name, ...parseEntry(text) });\n  }\n  return entries;\n}\n\nexport async function collateFiles(opts: {\n  entriesDir: string;\n  changelogPath: string;\n  version: string;\n}): Promise<CollateResult> {\n  const { entriesDir, changelogPath, version } = opts;\n  const entries = await readEntries(entriesDir);\n  const existing = await readFile(changelogPath, 'utf8');\n  const { body: unreleasedBody, md: mdNoUnreleased } =\n    extractUnreleased(existing);\n  if (entries.length === 0 && !unreleasedBody) return { noop: true };\n  if (hasVersion(mdNoUnreleased, version)) {\n    throw new Error(`## Version ${version} already exists in ${changelogPath}`);\n  }\n  const section = renderVersionSection(\n    version,\n    groupEntries(entries),\n    unreleasedBody\n  );\n  await writeFile(changelogPath, insertVersionSection(mdNoUnreleased, section));\n  await Promise.all(entries.map((e) => rm(join(entriesDir, e.name))));\n  return { noop: false, section };\n}\n\nasync function main(): Promise<void> {\n  const version = process.argv[2];\n  if (!version) {\n    console.error(\n      'usage: node --experimental-strip-types scripts/changelog-collate.ts <version>'\n    );\n    process.exit(1);\n  }\n  const here = dirname(fileURLToPath(import.meta.url));\n  const result = await collateFiles({\n    entriesDir: join(here, '..', 'changelog-next'),\n    changelogPath: join(here, '..', 'CHANGELOG.md'),\n    version\n  });\n  if (result.noop) {\n    console.error('changelog: nothing to collate');\n    return;\n  }\n  process.stdout.write(result.section);\n}\n\nif (\n  process.argv[1] &&\n  import.meta.url === pathToFileURL(process.argv[1]).href\n) {\n  main().catch((err: unknown) => {\n    console.error(err instanceof Error ? err.message : String(err));\n    process.exit(1);\n  });\n}\n"]}

package/dist/test/test/changelog.test.d.ts

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

package/dist/test/test/changelog.test.d.ts.map

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

package/dist/test/test/changelog.test.js

@@ -0,0 +1,293 @@
+import { mkdtemp, mkdir, writeFile, readFile, readdir, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterAll, describe, expect, it } from 'vitest';
+import { parseEntry, groupEntries, renderVersionSection, extractUnreleased, hasVersion, insertVersionSection, collateFiles } from '../scripts/changelog-collate.js';
+import { entryFileName, addEntry } from '../scripts/changelog-add.js';
+const tmpDirs = [];
+afterAll(async () => {
+    await Promise.all(tmpDirs.map((d) => rm(d, { recursive: true, force: true })));
+});
+describe('parseEntry', () => {
+    it('reads type and breaking from frontmatter and trims the body', () => {
+        const input = [
+            '---',
+            'type: fixed',
+            'breaking: true',
+            '---',
+            '- Fixed a thing.',
+            ''
+        ].join('\n');
+        expect(parseEntry(input)).toEqual({
+            type: 'fixed',
+            breaking: true,
+            body: '- Fixed a thing.'
+        });
+    });
+    it('defaults to empty type and breaking=false', () => {
+        const input = [
+            '---',
+            'type:',
+            'breaking: false',
+            '---',
+            '- A change.'
+        ].join('\n');
+        expect(parseEntry(input)).toEqual({
+            type: '',
+            breaking: false,
+            body: '- A change.'
+        });
+    });
+    it('ignores comment lines and inline comments in frontmatter', () => {
+        const input = [
+            '---',
+            '# type: omit for a normal change',
+            'type: deprecated  # note',
+            'breaking: false',
+            '---',
+            '- Deprecated X.'
+        ].join('\n');
+        expect(parseEntry(input)).toEqual({
+            type: 'deprecated',
+            breaking: false,
+            body: '- Deprecated X.'
+        });
+    });
+    it('treats a file with no frontmatter as an empty-type change', () => {
+        expect(parseEntry('- Just a bullet.')).toEqual({
+            type: '',
+            breaking: false,
+            body: '- Just a bullet.'
+        });
+    });
+});
+describe('groupEntries', () => {
+    const entry = (name, type, breaking) => ({
+        name,
+        type,
+        breaking,
+        body: `- ${name}`
+    });
+    it('buckets by type, sorts by filename, and keeps breaking out of its type section (Option A)', () => {
+        const grouped = groupEntries([
+            entry('b-feature.md', '', false),
+            entry('a-fix.md', 'fixed', false),
+            entry('c-breaking-fix.md', 'fixed', true),
+            entry('d-deprecate.md', 'deprecated', false)
+        ]);
+        expect(grouped).toEqual({
+            breaking: ['- c-breaking-fix.md'],
+            changes: ['- b-feature.md'],
+            fixed: ['- a-fix.md'],
+            deprecated: ['- d-deprecate.md']
+        });
+    });
+    it('falls back to changes for an unknown type', () => {
+        expect(groupEntries([entry('x.md', 'whoops', false)]).changes).toEqual([
+            '- x.md'
+        ]);
+    });
+});
+describe('renderVersionSection', () => {
+    it('renders sections in order and omits empty ones', () => {
+        const out = renderVersionSection('0.2.0', {
+            breaking: ['- Broke X.'],
+            changes: ['- Added Y.'],
+            fixed: [],
+            deprecated: []
+        });
+        expect(out).toBe([
+            '## Version 0.2.0',
+            '',
+            '### ⚠ Breaking',
+            '',
+            '- Broke X.',
+            '',
+            '### Changes',
+            '',
+            '- Added Y.',
+            ''
+        ].join('\n'));
+    });
+    it('appends an absorbed body verbatim after the generated sections', () => {
+        const out = renderVersionSection('0.2.0', { breaking: [], changes: ['- Added Y.'], fixed: [], deprecated: [] }, '### Notes\n\n- carried over');
+        expect(out).toBe([
+            '## Version 0.2.0',
+            '',
+            '### Changes',
+            '',
+            '- Added Y.',
+            '',
+            '### Notes',
+            '',
+            '- carried over',
+            ''
+        ].join('\n'));
+    });
+});
+describe('extractUnreleased', () => {
+    it('removes the Unreleased section and returns its body', () => {
+        const md = [
+            '# CHANGELOG',
+            '',
+            '## Unreleased',
+            '',
+            '- pending note',
+            '',
+            '## Version 0.1.0',
+            '',
+            '- old'
+        ].join('\n');
+        const { body, md: rest } = extractUnreleased(md);
+        expect(body).toBe('- pending note');
+        expect(rest).toBe(['# CHANGELOG', '', '## Version 0.1.0', '', '- old', ''].join('\n'));
+    });
+    it('returns an empty body when there is no Unreleased section', () => {
+        const md = ['# CHANGELOG', '', '## Version 0.1.0', '', '- old'].join('\n');
+        expect(extractUnreleased(md).body).toBe('');
+    });
+});
+describe('hasVersion', () => {
+    it('detects an existing version heading', () => {
+        const md = ['# CHANGELOG', '', '## Version 0.1.0', '', '- old'].join('\n');
+        expect(hasVersion(md, '0.1.0')).toBe(true);
+        expect(hasVersion(md, '0.2.0')).toBe(false);
+    });
+});
+describe('insertVersionSection', () => {
+    it('inserts the new version directly under the title, above older versions', () => {
+        const md = ['# CHANGELOG', '', '## Version 0.1.0', '', '- old', ''].join('\n');
+        const section = [
+            '## Version 0.2.0',
+            '',
+            '### Changes',
+            '',
+            '- new',
+            ''
+        ].join('\n');
+        expect(insertVersionSection(md, section)).toBe([
+            '# CHANGELOG',
+            '',
+            '## Version 0.2.0',
+            '',
+            '### Changes',
+            '',
+            '- new',
+            '',
+            '## Version 0.1.0',
+            '',
+            '- old',
+            ''
+        ].join('\n'));
+    });
+});
+async function tmpWorkspace(changelog, entries) {
+    const dir = await mkdtemp(join(tmpdir(), 'changelog-'));
+    tmpDirs.push(dir);
+    const entriesDir = join(dir, 'changelog-next');
+    await mkdir(entriesDir, { recursive: true });
+    const changelogPath = join(dir, 'CHANGELOG.md');
+    await writeFile(changelogPath, changelog);
+    for (const [name, text] of Object.entries(entries))
+        await writeFile(join(entriesDir, name), text);
+    return { entriesDir, changelogPath };
+}
+describe('collateFiles', () => {
+    const baseChangelog = [
+        '# CHANGELOG',
+        '',
+        '## Version 0.1.0',
+        '',
+        '- first',
+        ''
+    ].join('\n');
+    it('collates entries, deletes them, and returns the section', async () => {
+        const { entriesDir, changelogPath } = await tmpWorkspace(baseChangelog, {
+            '-template.md': '---\ntype:\n---\n- ignored template',
+            'feature.md': '---\ntype:\nbreaking: false\n---\n- Added a feature.',
+            'fix.md': '---\ntype: fixed\n---\n- Fixed a bug.'
+        });
+        const result = await collateFiles({
+            entriesDir,
+            changelogPath,
+            version: '0.2.0'
+        });
+        expect(result.noop).toBe(false);
+        if (result.noop === false) {
+            expect(result.section).toContain('## Version 0.2.0');
+            expect(result.section).toContain('### Changes\n\n- Added a feature.');
+            expect(result.section).toContain('### Fixed\n\n- Fixed a bug.');
+        }
+        const written = await readFile(changelogPath, 'utf8');
+        expect(written).toContain('## Version 0.2.0');
+        expect(written).toContain('## Version 0.1.0');
+        // template survives; consumed entries are gone
+        expect((await readdir(entriesDir)).sort()).toEqual(['-template.md']);
+    });
+    it('absorbs an existing Unreleased section on collation', async () => {
+        const changelog = [
+            '# CHANGELOG',
+            '',
+            '## Unreleased',
+            '',
+            '- carried note',
+            ''
+        ].join('\n');
+        const { entriesDir, changelogPath } = await tmpWorkspace(changelog, {});
+        const result = await collateFiles({
+            entriesDir,
+            changelogPath,
+            version: '0.2.0'
+        });
+        expect(result.noop).toBe(false);
+        const written = await readFile(changelogPath, 'utf8');
+        expect(written).toContain('## Version 0.2.0');
+        expect(written).toContain('- carried note');
+        expect(written).not.toContain('## Unreleased');
+    });
+    it('is a no-op when there are no entries and no Unreleased section', async () => {
+        const { entriesDir, changelogPath } = await tmpWorkspace(baseChangelog, {});
+        const result = await collateFiles({
+            entriesDir,
+            changelogPath,
+            version: '0.2.0'
+        });
+        expect(result.noop).toBe(true);
+        expect(await readFile(changelogPath, 'utf8')).toBe(baseChangelog);
+    });
+    it('errors when the target version already exists', async () => {
+        const { entriesDir, changelogPath } = await tmpWorkspace(baseChangelog, {
+            'feature.md': '---\ntype:\n---\n- Added a feature.'
+        });
+        await expect(collateFiles({ entriesDir, changelogPath, version: '0.1.0' })).rejects.toThrow('already exists');
+    });
+});
+describe('entryFileName', () => {
+    it('sanitizes slashes and ensures a single .md suffix', () => {
+        expect(entryFileName('fix/video bug')).toBe('fix-video bug.md');
+        expect(entryFileName('already.md')).toBe('already.md');
+        expect(entryFileName('a\\b')).toBe('a-b.md');
+    });
+    it('strips a leading dash so collate will not skip the entry', () => {
+        expect(entryFileName('-foo')).toBe('foo.md');
+    });
+});
+describe('addEntry', () => {
+    it('copies the template to a new entry file and returns its path', async () => {
+        const dir = await mkdtemp(join(tmpdir(), 'changelog-add-'));
+        tmpDirs.push(dir);
+        const entriesDir = join(dir, 'changelog-next');
+        await mkdir(entriesDir, { recursive: true });
+        const templatePath = join(entriesDir, '-template.md');
+        await writeFile(templatePath, '---\ntype:\nbreaking: false\n---\n- describe me');
+        const target = await addEntry({
+            templatePath,
+            entriesDir,
+            name: 'my-change'
+        });
+        expect(target).toBe(join(entriesDir, 'my-change.md'));
+        expect(await readFile(target, 'utf8')).toContain('- describe me');
+        await expect(addEntry({ templatePath, entriesDir, name: 'my-change' })).rejects.toThrow('already exists');
+    });
+});
+//# sourceMappingURL=changelog.test.js.map

package/dist/test/test/changelog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.test.js","sourceRoot":"","sources":["../../../test/changelog.test.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  mkdtemp,\n  mkdir,\n  writeFile,\n  readFile,\n  readdir,\n  rm\n} from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { afterAll, describe, expect, it } from 'vitest';\nimport {\n  parseEntry,\n  groupEntries,\n  renderVersionSection,\n  extractUnreleased,\n  hasVersion,\n  insertVersionSection,\n  collateFiles\n} from '../scripts/changelog-collate.js';\nimport { entryFileName, addEntry } from '../scripts/changelog-add.js';\n\nconst tmpDirs: string[] = [];\n\nafterAll(async () => {\n  await Promise.all(\n    tmpDirs.map((d) => rm(d, { recursive: true, force: true }))\n  );\n});\n\ndescribe('parseEntry', () => {\n  it('reads type and breaking from frontmatter and trims the body', () => {\n    const input = [\n      '---',\n      'type: fixed',\n      'breaking: true',\n      '---',\n      '- Fixed a thing.',\n      ''\n    ].join('\\n');\n    expect(parseEntry(input)).toEqual({\n      type: 'fixed',\n      breaking: true,\n      body: '- Fixed a thing.'\n    });\n  });\n\n  it('defaults to empty type and breaking=false', () => {\n    const input = [\n      '---',\n      'type:',\n      'breaking: false',\n      '---',\n      '- A change.'\n    ].join('\\n');\n    expect(parseEntry(input)).toEqual({\n      type: '',\n      breaking: false,\n      body: '- A change.'\n    });\n  });\n\n  it('ignores comment lines and inline comments in frontmatter', () => {\n    const input = [\n      '---',\n      '# type: omit for a normal change',\n      'type: deprecated  # note',\n      'breaking: false',\n      '---',\n      '- Deprecated X.'\n    ].join('\\n');\n    expect(parseEntry(input)).toEqual({\n      type: 'deprecated',\n      breaking: false,\n      body: '- Deprecated X.'\n    });\n  });\n\n  it('treats a file with no frontmatter as an empty-type change', () => {\n    expect(parseEntry('- Just a bullet.')).toEqual({\n      type: '',\n      breaking: false,\n      body: '- Just a bullet.'\n    });\n  });\n});\n\ndescribe('groupEntries', () => {\n  const entry = (name: string, type: string, breaking: boolean) => ({\n    name,\n    type,\n    breaking,\n    body: `- ${name}`\n  });\n\n  it('buckets by type, sorts by filename, and keeps breaking out of its type section (Option A)', () => {\n    const grouped = groupEntries([\n      entry('b-feature.md', '', false),\n      entry('a-fix.md', 'fixed', false),\n      entry('c-breaking-fix.md', 'fixed', true),\n      entry('d-deprecate.md', 'deprecated', false)\n    ]);\n    expect(grouped).toEqual({\n      breaking: ['- c-breaking-fix.md'],\n      changes: ['- b-feature.md'],\n      fixed: ['- a-fix.md'],\n      deprecated: ['- d-deprecate.md']\n    });\n  });\n\n  it('falls back to changes for an unknown type', () => {\n    expect(groupEntries([entry('x.md', 'whoops', false)]).changes).toEqual([\n      '- x.md'\n    ]);\n  });\n});\n\ndescribe('renderVersionSection', () => {\n  it('renders sections in order and omits empty ones', () => {\n    const out = renderVersionSection('0.2.0', {\n      breaking: ['- Broke X.'],\n      changes: ['- Added Y.'],\n      fixed: [],\n      deprecated: []\n    });\n    expect(out).toBe(\n      [\n        '## Version 0.2.0',\n        '',\n        '### ⚠ Breaking',\n        '',\n        '- Broke X.',\n        '',\n        '### Changes',\n        '',\n        '- Added Y.',\n        ''\n      ].join('\\n')\n    );\n  });\n\n  it('appends an absorbed body verbatim after the generated sections', () => {\n    const out = renderVersionSection(\n      '0.2.0',\n      { breaking: [], changes: ['- Added Y.'], fixed: [], deprecated: [] },\n      '### Notes\\n\\n- carried over'\n    );\n    expect(out).toBe(\n      [\n        '## Version 0.2.0',\n        '',\n        '### Changes',\n        '',\n        '- Added Y.',\n        '',\n        '### Notes',\n        '',\n        '- carried over',\n        ''\n      ].join('\\n')\n    );\n  });\n});\n\ndescribe('extractUnreleased', () => {\n  it('removes the Unreleased section and returns its body', () => {\n    const md = [\n      '# CHANGELOG',\n      '',\n      '## Unreleased',\n      '',\n      '- pending note',\n      '',\n      '## Version 0.1.0',\n      '',\n      '- old'\n    ].join('\\n');\n    const { body, md: rest } = extractUnreleased(md);\n    expect(body).toBe('- pending note');\n    expect(rest).toBe(\n      ['# CHANGELOG', '', '## Version 0.1.0', '', '- old', ''].join('\\n')\n    );\n  });\n\n  it('returns an empty body when there is no Unreleased section', () => {\n    const md = ['# CHANGELOG', '', '## Version 0.1.0', '', '- old'].join('\\n');\n    expect(extractUnreleased(md).body).toBe('');\n  });\n});\n\ndescribe('hasVersion', () => {\n  it('detects an existing version heading', () => {\n    const md = ['# CHANGELOG', '', '## Version 0.1.0', '', '- old'].join('\\n');\n    expect(hasVersion(md, '0.1.0')).toBe(true);\n    expect(hasVersion(md, '0.2.0')).toBe(false);\n  });\n});\n\ndescribe('insertVersionSection', () => {\n  it('inserts the new version directly under the title, above older versions', () => {\n    const md = ['# CHANGELOG', '', '## Version 0.1.0', '', '- old', ''].join(\n      '\\n'\n    );\n    const section = [\n      '## Version 0.2.0',\n      '',\n      '### Changes',\n      '',\n      '- new',\n      ''\n    ].join('\\n');\n    expect(insertVersionSection(md, section)).toBe(\n      [\n        '# CHANGELOG',\n        '',\n        '## Version 0.2.0',\n        '',\n        '### Changes',\n        '',\n        '- new',\n        '',\n        '## Version 0.1.0',\n        '',\n        '- old',\n        ''\n      ].join('\\n')\n    );\n  });\n});\n\nasync function tmpWorkspace(\n  changelog: string,\n  entries: Record<string, string>\n) {\n  const dir = await mkdtemp(join(tmpdir(), 'changelog-'));\n  tmpDirs.push(dir);\n  const entriesDir = join(dir, 'changelog-next');\n  await mkdir(entriesDir, { recursive: true });\n  const changelogPath = join(dir, 'CHANGELOG.md');\n  await writeFile(changelogPath, changelog);\n  for (const [name, text] of Object.entries(entries))\n    await writeFile(join(entriesDir, name), text);\n  return { entriesDir, changelogPath };\n}\n\ndescribe('collateFiles', () => {\n  const baseChangelog = [\n    '# CHANGELOG',\n    '',\n    '## Version 0.1.0',\n    '',\n    '- first',\n    ''\n  ].join('\\n');\n\n  it('collates entries, deletes them, and returns the section', async () => {\n    const { entriesDir, changelogPath } = await tmpWorkspace(baseChangelog, {\n      '-template.md': '---\\ntype:\\n---\\n- ignored template',\n      'feature.md': '---\\ntype:\\nbreaking: false\\n---\\n- Added a feature.',\n      'fix.md': '---\\ntype: fixed\\n---\\n- Fixed a bug.'\n    });\n    const result = await collateFiles({\n      entriesDir,\n      changelogPath,\n      version: '0.2.0'\n    });\n    expect(result.noop).toBe(false);\n    if (result.noop === false) {\n      expect(result.section).toContain('## Version 0.2.0');\n      expect(result.section).toContain('### Changes\\n\\n- Added a feature.');\n      expect(result.section).toContain('### Fixed\\n\\n- Fixed a bug.');\n    }\n    const written = await readFile(changelogPath, 'utf8');\n    expect(written).toContain('## Version 0.2.0');\n    expect(written).toContain('## Version 0.1.0');\n    // template survives; consumed entries are gone\n    expect((await readdir(entriesDir)).sort()).toEqual(['-template.md']);\n  });\n\n  it('absorbs an existing Unreleased section on collation', async () => {\n    const changelog = [\n      '# CHANGELOG',\n      '',\n      '## Unreleased',\n      '',\n      '- carried note',\n      ''\n    ].join('\\n');\n    const { entriesDir, changelogPath } = await tmpWorkspace(changelog, {});\n    const result = await collateFiles({\n      entriesDir,\n      changelogPath,\n      version: '0.2.0'\n    });\n    expect(result.noop).toBe(false);\n    const written = await readFile(changelogPath, 'utf8');\n    expect(written).toContain('## Version 0.2.0');\n    expect(written).toContain('- carried note');\n    expect(written).not.toContain('## Unreleased');\n  });\n\n  it('is a no-op when there are no entries and no Unreleased section', async () => {\n    const { entriesDir, changelogPath } = await tmpWorkspace(baseChangelog, {});\n    const result = await collateFiles({\n      entriesDir,\n      changelogPath,\n      version: '0.2.0'\n    });\n    expect(result.noop).toBe(true);\n    expect(await readFile(changelogPath, 'utf8')).toBe(baseChangelog);\n  });\n\n  it('errors when the target version already exists', async () => {\n    const { entriesDir, changelogPath } = await tmpWorkspace(baseChangelog, {\n      'feature.md': '---\\ntype:\\n---\\n- Added a feature.'\n    });\n    await expect(\n      collateFiles({ entriesDir, changelogPath, version: '0.1.0' })\n    ).rejects.toThrow('already exists');\n  });\n});\n\ndescribe('entryFileName', () => {\n  it('sanitizes slashes and ensures a single .md suffix', () => {\n    expect(entryFileName('fix/video bug')).toBe('fix-video bug.md');\n    expect(entryFileName('already.md')).toBe('already.md');\n    expect(entryFileName('a\\\\b')).toBe('a-b.md');\n  });\n\n  it('strips a leading dash so collate will not skip the entry', () => {\n    expect(entryFileName('-foo')).toBe('foo.md');\n  });\n});\n\ndescribe('addEntry', () => {\n  it('copies the template to a new entry file and returns its path', async () => {\n    const dir = await mkdtemp(join(tmpdir(), 'changelog-add-'));\n    tmpDirs.push(dir);\n    const entriesDir = join(dir, 'changelog-next');\n    await mkdir(entriesDir, { recursive: true });\n    const templatePath = join(entriesDir, '-template.md');\n    await writeFile(\n      templatePath,\n      '---\\ntype:\\nbreaking: false\\n---\\n- describe me'\n    );\n\n    const target = await addEntry({\n      templatePath,\n      entriesDir,\n      name: 'my-change'\n    });\n    expect(target).toBe(join(entriesDir, 'my-change.md'));\n    expect(await readFile(target, 'utf8')).toContain('- describe me');\n\n    await expect(\n      addEntry({ templatePath, entriesDir, name: 'my-change' })\n    ).rejects.toThrow('already exists');\n  });\n});\n"]}

package/dist/test/test/cli/dispatcher.test.js

@@ -1,17 +1,18 @@
 import { spawnSync } from 'node:child_process';
 import path from 'node:path';
+import { tmpdir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { describe, expect, it } from 'vitest';
 const here = path.dirname(fileURLToPath(import.meta.url));
 const CLI = path.resolve(here, '..', '..', 'dist', 'cli.js');
-function run(args) {
+function run(args, extraEnv = {}) {
     const r = spawnSync('node', [CLI, ...args], {
         encoding: 'utf8',
         // Don't inherit env — the bare/--help/unknown paths must succeed
         // regardless of CESDK_LICENSE etc., since they don't actually start a
         // transport.
-        env: { PATH: process.env.PATH ?? '' },
-        timeout: 5000
+        env: { PATH: process.env.PATH ?? '', ...extraEnv },
+        timeout: 10000
     });
     return {
         code: r.status ?? -1,
@@ -43,5 +44,11 @@ describe('codesign-mcp dispatcher', () => {
         expect(r.code).toBe(2);
         expect(r.stderr).toContain('unknown subcommand "bogus"');
     });
+    it('diagnose: exits 0 and prints a .zip path to stdout', () => {
+        const diagDir = path.join(tmpdir(), `diag-dispatcher-test-${Date.now()}`);
+        const r = run(['diagnose'], { IMGLY_DIAGNOSTICS_DIR: diagDir });
+        expect(r.code).toBe(0);
+        expect(r.stdout).toContain('.zip');
+    });
 });
 //# sourceMappingURL=dispatcher.test.js.map