# Changelog

All notable changes use semantic versioning.

Historical `1.0.0` through `1.0.4` entries were reconstructed from the published npm artifacts and their registry-recorded `gitHead` values. See [`docs/releases/`](docs/releases/) for provenance details.

## 1.2.0 — 2026-07-17

- Added one focused motion contract: generated semantic SVG in, validated GIF plus a JSON motion report out. The renderer rejects raster inputs and unsupported media formats.
- Added twelve user-approved style signatures: headed memory packets, terminal evidence traces, blueprint registration beads, Notion memory cards, glass task capsules, governance seals, API token trains, gem tracers, C4 review cursors, active-active cloud chevrons, event trains, and an ops-pulse scanner.
- Changed the default GIF timeline to 5.75s/115 frames at 20fps. Routes construct on frames 1–36, live flow reaches full opacity at frame 38, settled flow continues through frame 109, and reset remains frames 110–114. Explicit 3.75s/75-frame and 2.75s/55-frame timelines remain supported.
- Replaced all 13 README showcase positions with approved GIFs, including a synchronized 3×4 overview below 2 MiB. Added a public SHA-256/metadata manifest and binary GIF parsing for dimensions, cadence, frame count, duration, and infinite-loop readback. Retained regenerated 1920px PNGs as static regression baselines.
- Updated the GitHub Pages product site to showcase the animated overview and all twelve style GIFs, with static social-card media and reduced-motion fallbacks retained.
- Added bounded runtime probes, secure Puppeteer resolution, source-DOM immutability guards, frame uniqueness and periodic-motion gates, FFprobe validation, atomic GIF/report installation, explicit encoder requirements, and a 500KB per-style guidance target.
- Kept valid same-style title/content variants animatable by pinning semantic topology, route roles, order, direction, stage, geometry, and style signatures instead of exact source bytes.
- Added a real-Chromium 12-style 75-vs-115 regression covering 852 comparisons, plus installed-copy all-style motion canaries in CI and the tag-release workflow.
- Fixed transformed SVG bounds to inspect all four corners and corrected multi-subpath bridge counting. Refreshed the Style 6 and Style 7 PNG baselines to match the canonical renderer.
- Updated Codex and Claude Code installation guidance so optional motion dependencies are installed into each copied Skill root.

## 1.1.0 — 2026-07-15

- Added four engineering-first styles: C4 Review Canvas, Cloud Fabric, Event Transit, and Ops Pulse, each with an executable semantic contract, distinct prompt fingerprints, and showcase fixtures.
- Added schema v1 normalization, typed node/edge IR, deterministic layout reports, and a unified CLI.
- Added geometry-safe orthogonal routing, mandatory waypoint validation, port fan-out, label/canvas checks, legend relocation, edge-crossing bridges, and semantic SVG metadata.
- Added strict SVG geometry validation and regression coverage for line crossings, reserved regions, clipping, and bridge masks.
- Added safe offline interactive HTML export with pan, zoom, theme switching, copy, and SVG/PNG/JPEG/WebP export up to 4×.
- Added a complete nested Agent Skill distribution for reliable `npx skills add` installation.
- Added CI, release archives, archive parity checks, project consistency checks, and isolated install canaries.
- Refreshed the official 12-style PNG showcase and product website with one distinct engineering scenario per style.
- Raised the supported Node.js runtime baseline to Node.js 18+.

## 1.0.5 — 2026-07-11

- Added shared Codex and Claude Code support, compatibility metadata, tests, and installation guidance.
- Added Style 8 Dark Luxury and expanded the gallery to eight distinct visual styles.
- Added a bounded generate-validate-repair loop, structural SVG validation, and optional visual self-review.
- Improved connector routing, label placement, overlap prevention, clipping guidance, CJK font fallbacks, and helper-script robustness.
- Switched the default PNG renderer to CairoSVG and documented renderer-specific edge cases.
- Added the first GitHub Pages product showcase.

## 1.0.4 — 2026-04-12

- Added an explicit `npx skills add ... --force -g -y` update workflow to the English README, Chinese README, and Skill instructions.
- Published npm package `1.0.4` with Node.js 14+ metadata.

## 1.0.3 — 2026-04-12

- Clarified that `skills add` installs from the GitHub repository while npm remains the package and distribution page.
- Replaced the legacy install example with `npx skills add yizhiyanhua-ai/fireworks-tech-graph`.
- Published npm package `1.0.3` with the corrected install-source guidance.

## 1.0.2 — 2026-04-12

- Added the style-driven generator, fixtures, reusable SVG templates, and a seven-style diagram matrix.
- Refreshed the seven official showcase images and expanded SVG validation and all-style test scripts.
- Added formal npm package metadata for repository, license, files, runtime, and discovery keywords.
- Expanded the npm package payload to include fixtures and templates.

## 1.0.1 — 2026-04-12

- Added an explicit layout validation checklist covering connector-node collisions, text overflow, endpoint alignment, and label backgrounds.
- Normalized npm repository metadata.

## 1.0.0 — 2026-04-12

- Published the first npm package for the Agent Skill.
- Shipped seven built-in diagram styles, SVG and PNG generation, architecture and UML guidance, validation scripts, and bilingual documentation.
